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ABSTRACT 


Future  computer  networks,  including  the  Next  Generation  Internet  (NGI),  will 
have  to  support  applications  with  a  wide  range  of  service  requirements,  such  as  real-time 
communication  services.  These  applications  are  particularly  demanding  since  they 
require  performance  guarantees  expressed  in  terms  of  delay,  delay  jitter,  throughput  and 
loss  rate  bounds.  In  order  to  provide  such  quality-of-service  (QoS)  guarantees,  the 
network  must  implement  a  Resource  Reservation  mechanism  for  reserving  resources  such 
as  bandwidth  for  individual  connections.  Additionally,  the  network  must  have  an 
Admission  Control  mechanism,  for  selectively  rejecting  some  QoS-sensitive  flow 
requests  based  on  resource  availability  or  administrative  policies. 

The  Server  and  Agent  based  Active  network  Management  (SAAM)  is  a  network 
management  system  designed  to  meet  the  requirements  of  NGI.  In  SAAM,  emerging 
services  models  like  Integrated  Services  (IntServ)  and  Differentiated  Services  (DiflServ), 
and  the  classical  Best  Effort  service  are  concurrently  sharing  network  resources.  This 
thesis  develops  and  demonstrates  in  SAAM  a  novel  resource  management  concept  that 
addresses  the  difficulties  posed  by  QoS  networks.  With  the  new  resource  reservation  and 
admission  control  approaches,  the  sharing  mechanism  is  dynamic  and  adapts  to  network 
load.  It  ensures  high  resource  utilization  while  meeting  QoS  requirements  of  network 
users. 
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I.  INTRODUCTION 


A,  MOTIVATION 

Quality-of-Service  (QoS)  is  definitely  one  of  the  most  popular  and  ehallenging 
research  topics  in  Internet  computer  networking  nowadays.  Today’s  Internet  is  an 
extremely  versatile  communication  service  for  a  wide  range  of  applications.  However,  it 
is  only  aimed  at  providing  best-effort  (BE)  service,  where  traffic  is  processed  as  quickly 
as  possible,  with  no  guarantees  as  to  timeliness  or  actual  delivery.  Although  this  model 
perfectly  fits  many  applications  like  e-mail  or  regular  web  browsing,  it  is  commonly 
perceived  that  the  best  effort  service  cannot  adequately  support  delay-sensitive  and/or 
loss-sensitive  applications,  such  as  Internet  telephony,  multimedia  conferencing, 
telemedicine  and  many  others.  These  applications  have  in  common  the  requirement  for 
certain  level  of  network  QoS  guarantees,  measured  by  throughput,  network  delay  and 
data  loss  rate. 

In  order  to  meet  the  QoS  requirements  of  all  potential  traffic  over  the  Internet, 
different  approaches  have  been  proposed.  The  Differentiated  Services  (DiflServ) 
approach  is  intended  to  provide  a  discrete  number  of  service  levels  or  classes,  thus 
making  it  a  scalable  solution.  Since  DiflServ  only  prioritizes  traffic  among  a  limited 
number  of  classes,  it  does  not  truly  provide  for  full  QoS  guarantees  on  a  per  user  session 
basis.  A  different  approach,  the  Integrated  Service  (IntServ)  model  is  aimed  to  provide 
per-fiow  QoS  guarantees,  where  a  flow  may  represent  the  traffic  generated  by  individual 
applications. 

QoS  guarantees  can  only  be  met  if  network  resources  such  as  link  capacity  and 
buffer  space  are  previously  allocated  to  requesting  applications.  Such  a  mechanism  is 
called  Resource  Reservation.  Networks  must  also  have  a  way  of  selectively  rejecting  new 
flow  requests  based  on  resource  availability  or  administrative  policies.  This  mechanism  is 
called  Admission  Control.  Additionally,  with  the  requirement  to  support  multiple  classes 
of  service  over  the  same  infrastructure,  networks  have  to  provide  a  model  for  Link 
Sharing  1.  Collectively,  resource  reservation,  admission  control,  and  link  sharing  address 
1  Also  termed  Network  Provisioning 
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the  problem  of  Resouree  Management.  Sinee  applieations  with  vastly  different  QoS 
demands  will  need  to  use  the  same  infrastructure,  resource  management  solutions  must 
be  flexible,  adapting  to  different  traffic  mixes  and  load  fluctuations.  Moreover,  a  growing 
number  of  applications  not  only  demand  QoS  guarantees  but  also  generate  an 
increasingly  large  volume  of  data,  putting  a  huge  load  on  current  networks.  Thus,  another 
important  objective  of  resource  management  is  efficient  use  of  resources. 

Next  Generation  Internet  (NGI)  is  one  of  several  initiatives  of  the  networking 
community  to  develop  networks  capable  of  both  guaranteed  and  best  effort  services.  The 
Server  and  Agent  based  Active  network  Management  or  SAAM,  is  an  ongoing  research 
project  under  the  NGI  initiative  and  it  is  sponsored  by  the  Defense  Advanced  Research 
Projects  Agency  (DARPA)  and  National  Aeronautics  and  Space  Administration  (NASA). 
SAAM  implements  and  proves  the  feasibility  of  a  server-based  network  management 
concept  that  addresses  the  resource  management  problem. 

B,  MILITARY  RELEVANCE 

The  vision  for  future  joint  war  fighting  of  US  military  is  described  in  Joint  Vision 
2020  (JV2020)  [1].  The  concept  of  network-centric  warfare  (NCW),  first  conveyed  in  the 
JV2010  and  carried  forward  in  JV2020,  represents  a  fundamental  shift  from  the  previous 
platform-centric  warfare.  Interoperability  with  external  agencies  and  among  forces  of  the 
allied  nations  is  a  growing  necessity  as  recently  proved  with  the  combined  NATO 
operations  in  the  Balkans.  Military  operations  in  the  current  information  age  are 
organized  around  the  NCW  concept,  through  which  information  superiority  translates 
into  increased  combat  power.  NCW  is  enabled  by  effectively  networking  sensors, 
decision  makers  and  shooters  to  achieve  shared  awareness,  increased  speed  of  command 
and  high  levels  of  self-synchronization. 

The  NCW  environment  creates  a  wide  range  of  network  service  requirements, 
only  possible  to  meet  through  active  and  adaptive  networks.  SAAM  is  one  of  such 
networks  being  prototyped  at  the  Naval  Postgraduate  School.  Appendix  A  identifies  some 
key  enabler  technologies  of  SAAM,  which  illustrate  the  importance  of  SAAM  in  the 
context  of  the  NCW  environment.  The  work  of  this  thesis  greatly  contributes  for  the 
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improvement  of  the  SAAM  eoneept  and  further  extends  the  potential  of  SAAM  to 
beeome  a  solution  to  the  technical  problems  posed  by  NCW. 

C.  THESIS  OBJECTIVES 

The  main  objective  of  this  research  is  to  develop,  implement  and  test  a 
mechanism  for  managing  the  resources  of  quality  of  service  capable  networks,  like 
SAAM.  Special  consideration  is  made  with  regard  to  multiple  classes  of  QoS  services 
sharing  the  same  network  infrastructure  and  the  resource  allocation  mechanism  for 
efficient  utilization  of  network  resources. 

D,  RESEARCH  QUESTIONS 

This  thesis  study  provides  answers  for  the  following  questions:  (1)  how  can 
SAAM  efficiently  manage  network  resources  while  providing  support  for  different 
classes  of  QoS  traffic?  (2)  What  is  the  impact  of  inter-service  borrowing  on  the  overall 
performance  of  QoS  capable  networks  like  SAAM? 

E.  SCOPE  OF  THE  STUDY 

Previous  research  efforts  have  already  showed  to  be  feasible  the  concept  of  a 
central  network  management  authority  for  providing  QoS  guarantees  to  network  users,  as 
current  SAAM  prototype  demonstrates.  Cheng  and  Gibson  [2],  and  Queck  [3]  created  the 
foundations  for  a  QoS  management  model.  This  thesis  draws  from  their  work,  but  is 
mainly  focused  on  extending  the  potential  of  SAAM  servers  to  efficiently  and 
dynamically  manage  network  resources  while  supporting  different  classes  of  guaranteed 
services.  Specifically,  the  core  data  structure  residing  in  the  heart  of  SAAM,  the  Path 
Information  Base  (PIB),  has  been  redesigned  to  provide  support  for  a  novel  and  more 
efficient  resource  management  mechanism. 

F,  THESIS  ORGANIZATION 

The  remainder  of  the  thesis  is  organized  into  the  following  chapters: 

•  Chapter  II  -  Background.  This  chapter  introduces  some  of  the  underlying 
concepts  related  with  quality-of-service  and  resource  management  in  next 
generation  networks.  Additionally,  a  brief  description  of  the  SAAM  concept  is 
presented. 
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•  Chapter  III  -  Efficient  Resource  Management.  This  chapter  details  the 
development  of  the  resource  management  mechanism  required  to  manage 
resources  of  QoS  capable  networks  like  SAAM.  In  specific,  a  novel  inter¬ 
service  borrowing  mechanism  is  presented. 

•  Chapter  IV  -  Design.  Details  the  design  of  the  network  management 
mechanism  as  applicable  to  SAAM. 

•  Chapter  V  -  Implementation.  Describes  the  implementation  and  integration 
details  of  the  resource  management  mechanism  developed  in  this  thesis. 

•  Chapter  VI  -  PIB  Test  and  Performance  Analysis.  Describes  the  test  and 
evaluation  of  PIB. 

•  Chapter  VII  -  Conclusions  and  Recommendations.  Concludes  the  thesis  study 
with  conclusions  and  the  identification  of  areas  of  further  study. 

•  Finally,  several  appendixes  are  included  to  support  the  thesis  study. 
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II.  BACKGROUND 


Current  trends  in  the  development  of  real-time  network  applications  indicate  that 
the  future  Internet  architecture  will  need  to  support  a  diversity  of  applications  with 
different  QoS  requirements.  Ongoing  research  on  QoS  has  proven  that  enabling  end-to- 
end  QoS  over  the  Internet  introduces  complexity  in  its  overall  functionality.  Moreover,  it 
affects  areas  like  network  management,  business  patterns  of  networking  companies,  and 
it  also  changes  the  way  customer  perceives  the  services  offered  by  the  network.  Finding 
an  efficient  solution  for  end-to-end  QoS  over  the  Internet  is  not  only  one  the  most 
popular  but  also  a  very  challenging  research  topic  in  computer  networking  today. 

The  current  Internet  architecture  provides  only  simple  services  like  IP  addressing, 
routing,  fragmentation  and  reassembling  of  IP  datagrams.  It  relies  on  higher-level 
transport  protocols  for  sequential  and  assured  data  delivery,  and  provides  no  guarantee  as 
to  timeliness  and  throughput  of  traffic.  These  services  are  widely  known  as  best-effort 
services.  Although  these  services  are  sufficient  for  traditional  Internet  applications  like  e- 
mail,  web  browsing  or  file-transfer,  the  same  is  not  true  for  the  emerging  wave  of 
applications  like  IP  telephony,  multimedia  conferencing,  or  audio  and  video  streaming. 
Consequently,  the  need  to  provide  the  current  Internet  with  the  mechanisms  required  to 
support  QoS  on  the  Internet  is  natural. 

The  SAAM  project  currently  under  development  at  the  Naval  Postgraduate 
School  defines  and  implements  a  model  of  network  management  that  provides  a  solution 
for  the  so-called  Next  Generation  Internet  (NGI).  This  chapter  gives  an  overview  of 
current  Internet  architectures  related  with  providing  QoS  over  the  Internet,  and  how  they 
fit  the  QoS  requirement  of  next  generation  internet.  Additionally,  the  SAAM  model  is 
briefly  described. 

A,  QUALITY  OF  SERVICE  ARCHITECTURES 

The  efforts  to  enable  end-to-end  QoS  over  the  existing  IP  infrastructure,  have  led 
to  the  development  of  two  different  architectures:  the  Integrated  Services  (IntServ) 
architecture  and  the  Differentiated  Services  (DiflServ)  architecture.  Although 
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fundamentally  different,  both  of  these  architectures  are  designed  to  support  QoS  over  the 
Internet. 

1.  Integrated  Service 

The  aim  of  the  Integrated  Service  architecture  is  to  provide  customer  on-demand 
QoS  guarantees,  e.g.  bandwidth,  delay  and  loss  rate,  and  is  ideally  suited  for  real-time 
applications.  The  architectural  design  of  IntServ  is  based  on  the  notion  that  in  order  to 
fulfill  the  QoS  requirement  of  the  customers,  network  resources  should  be  managed  and 
controlled  [4],  thus  implying  that  the  admission  control  and  resource  reservation  are  the 
building  blocks  of  this  architecture.  Event  though  IntServ  provides  the  means  for  end-to- 
end  QoS,  it  is  still  not  widely  implemented.  Due  to  the  maintenance  of  per-fiow 
information,  classification,  reserving  and  management  resources  per-flow  introduces 
complex  scalability  problems,  especially  at  the  core  of  high-speed  networks  where  the 
number  of  flows  to  process  is  in  the  thousands  to  million  ranges.  Currently,  IntServ  has 
proven  to  be  easily  deployed  only  in  small  networks,  where  the  number  of  IntServ  flow  is 
moderate  and  manageable. 

2.  Differentiated  Services 

The  Differentiated  Services  architecture  or  DifiEerv  was  developed  to  avoid  the 
scalability  problem  and  the  complexity  of  IntServ.  However,  DiflServ  only  provides 
quality  differentiation  on  traffic  aggregates  without  strict  guarantees  on  individual  flows. 
This  quality  differentiation  only  offers  to  network  users  the  guarantee  that  some  traffic 
receives  better  service  than  others.  The  few  predetermined  levels  of  QoS  are  usually 
called  traffic  classes.  As  an  example  of  a  DifiEerv  model,  classes  may  referred  to  as 
Gold,  Silver  and  Bronze.  Access  control  to  service  is  regulated  by  pre-established  service 
level  agreements  (SLA)  between  network  access  providers  (ISPs)  and  their  clients,  which 
specify  the  service  level  agreed  upon  and  the  fees  of  the  service. 

B,  RESOURCE  MANAGEMENT 

There  are  a  number  of  emerging  requirements  for  resource  management  in  the 

Internet;  these  requirements  include  both  link-sharing  services  and  services  for 

supporting  QoS  traffic.  Link-sharing  is  required  whenever  network  resources  are  to  be 

shared  among  different  agencies  or  traffic  classes.  Resource  reservation  and  admission 
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control  are  the  base  for  providing  QoS  guarantees.  All  these  three  meehanisms  play  a 
vital  role  for  the  efficient  management  of  resourees  in  modern  QoS  networks. 

1.  Resource  Reservation 

As  stated  in  [4],  there  is  an  inescapable  requirement  for  networks  to  be  able 
reserve  resourees,  in  order  to  provide  QoS  guarantees  for  speeifie  user  flows.  The 
alloeation  of  resourees  is  typieally  done  on  a  flow-by-flow  basis  as  eaeh  new  flow 
requests  admission  to  the  network.  This  in  turn,  requires  flow-speeifie  state  information 
to  be  kept  by  routers  along  the  path  followed  by  the  flow.  In  current  Internet,  based  on 
the  best-effort  model,  state  information  is  only  maintained  by  end  applieations.  Sueh  a 
stateless  network  is  simple,  robust  and  scales  very  well.  A  soft  state  approach  for  a  QoS 
network  would  be  desirable.  Currently,  the  Resource  Reservation  Protoeol  (RSVP)  is 
being  used  to  support  reservation  of  resourees  over  an  IP  based  network.  It  does  so  by 
simply  providing  a  set  of  rules  for  the  network  and  requesting  applieations  to  exehange 
information  regarding  the  QoS  requirement  and  admission  and  then  to  setup  the  required 
network  resourees. 

2.  Admission  Control 

Admission  eontrol  is  required  to  implement  the  deeision  logie  that  determines 
whether  a  new  flow  ean  be  granted  the  requested  QoS,  without  affeeting  guarantees 
already  granted  to  previously  admitted  flows.  In  addition  to  ensuring  that  QoS  guarantees 
are  met,  admission  eontrol  may  be  used  to  enforce  network  administrative  polieies  on 
resouree  reservations.  Finally,  admission  eontrol  may  also  be  an  important  tool  on 
aeeounting  and  network  administrative  reporting.  The  simplest  model  of  admission 
eontrol  would  be  the  ease  in  whieh  the  user  asks  for  a  speeifie  QoS  and  the  network 
either  aeeepts  or  deelines  the  request  depending  upon  available  resourees.  Sinee  many 
applieations  can  still  be  able  to  get  aeeeptable  serviee  for  different  levels  of  QoS,  the 
negotiation  may  often  be  more  eomplex  until  a  final  flow  spee  is  agreed  upon. 

As  previously  stated,  the  network  is  required  to  keep  state  information,  i.e., 
remember  the  QoS  parameters  of  past  requests.  One  approaeh  to  admit  a  new  flow  would 
be  to  eompute  the  worse  ease  QoS  bounds  for  each  service  based  on  sueh  state 
information.  A  different  approaeh,  which  is  likely  to  provide  better  resource  utilization, 
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would  rely  on  routers  monitoring  actual  link  usage  by  existing  flows,  and  use  this 
measured  data  as  the  basis  for  admission  control.  Although  this  approach  as  a  higher  risk 
of  overload,  it  may  yield  more  efficient  link  utilization.  Furthermore,  such  a  soft  state 
approach  may  scale  better  for  large-scale  deployment. 

3,  Link  Sharing 

Link-sharing  is  a  resource  management  mechanism  created  to  manage  network 
resources,  such  as  bandwidth.  Link-sharing  relies  on  the  basic  assumption  that  bandwidth 
is  a  network  resource  that  will  always  be  limited.  Some  argue  that  when  technologies  like 
optic  fiber  be  fully  matured  and  widely  adopted,  bandwidth  will  no  longer  be  of  concern. 
However,  the  most  commonly  accepted  counter-argument  says  that  new  applications  will 
then  exist  to  consume  existing  bandwidth.  Link-sharing  services  are  required  whenever  a 
network  link  is  to  be  shared  between  agencies,  protocol  families,  or  service  classes  [5]. 
Multiple  agencies  may  share  the  bandwidth  of  a  link,  where  each  one  pays  a  fixed  share 
of  the  costs,  expecting  to  receive  a  guaranteed  share  of  the  link  bandwidth.  A  second 
requirement  is  for  link  sharing  of  bandwidth  on  a  link  between  protocol  families. 
Controlled  link  sharing  is  desirable  because  protocols  families  have  different  responses  to 
congestion.  Another  example  for  link-sharing  is  to  share  the  bandwidth  on  a  link  between 
different  classes  of  services,  such  as  IntServ,  Difffierv  and  Best  Effort  classes.  All  of  the 
above  three  examples  of  link  sharing  explicitly  deal  with  the  aggregation  of  traffic  on  a 
link.  While  there  are  a  number  of  different  motivations  for  link-sharing  in  the  network, 
the  requirements  for  link-sharing  are  essentially  the  same,  whether  the  link  sharing  is 
between  organizations,  service  classes  or  families  of  protocols. 

C.  OVERVIEW  OF  SAAM 

SAAM  is  an  intelligent  active  network  management  system,  developed  to  meet 
the  requirements  of  next  generation  Internet.  SAAM  offers  a  solution  to  the  problem  of 
providing  QoS  guarantees  while  maintaining  the  simplicity,  robustness  and  scalability  of 
its  underlying  TCP/IP  architecture.  The  SAAM  model  establishes  a  hierarchy  of  servers 
and  routers  that  are  grouped  into  hierarchically  structured  SAAM  regions,  as  depicted  in 
figure  2.1.  SAAM  servers  assume  the  responsibility  of  all  network  management  decisions 
within  their  own  region,  thus  allowing  for  SAAM  lightweight  routers  to  focus  only  on 
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traffic  forwarding.  This  novel  approach  is  the  basis  for  implementing  a  complex  service 
model  that  integrates  multiple  elasses  of  QoS  services.  The  service  model  for  SAAM 
provides  support  for  IntServ  and  Difffierv  and  with  the  current  best-effort  services. 


1.  SAAM  Server 

The  SAAM  server  is  a  vital  player  within  the  SAAM  architecture.  The  server 
dynamically  builds  and  updates  a  knowledge  base  ealled  Path  Information  Base  (PIB) 
about  its  region  upon  receiving  status  information  from  its  dependent  routers.  As  the 
central  repository  of  information  for  the  SAAM  region,  the  server  is  in  a  privileged 
position  to  make  the  best  decisions  in  terms  of  granting  network  resourees,  optimizing 
network  utilization,  seleetion  of  the  best  routes,  perform  load  balancing  and  any  other 
network  operational  and  administrative  tasks,  without  having  the  burden  of  traffic 
processing  only  assoeiated  with  the  routers. 

2.  SAAM  Router 

Unlike  standalone  routers  in  existing  IP  networks,  the  SAAM  router  is 
coneeptually  simple  and  robust.  Sinee  all  complex  QoS  routing  deeisions  are  taken  by  the 
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server,  the  main  task  of  the  router  is  to  proeess  and  forward  traffic.  Additionally,  they 
monitor  traffic  and  periodically  report  to  the  Server,  the  status  of  their  links.  The  status 
information  includes  current  link  utilization,  packet  delay  and  data  loss  rate,  on  a  per- 
service-class  basis.  Routing  tables  are  updated  by  the  server  and  contain  information 
about  the  flow  label  and  outbound  interface  to  next  router.  SAAM  routers  are  therefore 
required  to  maintain  minimal  state  information,  which  provides  for  scalability. 

3.  SAAM  Operation 

The  SAAM  server  initially  discovers  its  region  by  flooding  down  the  network 
with  a  special  control  message.  Routers  will  in  turn  be  aware  of  their  server  and  report 
back  their  existence,  which  include  all  links  between  them  and  physical  bandwidth 
available  at  their  interfaces.  The  server  uses  this  information  to  identify  all  paths  within 
its  region  and  to  initially  allocate  bandwidth  among  all  services  classes  supported,  before 
starting  accepting  user  traffic.  Users  request  service  at  edge  routers,  which  in  turn  will 
forward  the  request  to  the  server.  The  admission  control  mechanism  is  then  responsible 
for  either  accepting  or  rejecting  the  request  based  upon  resource  availability.  Flow 
acceptance  results  in  resources  being  allocated  at  each  router  along  the  selected  path  prior 
to  send  the  new  traffic.  Edge  routers  maintain  enough  per-flow  information,  required  for 
the  purpose  of  traffic  control  and  policing.  At  ingress  or  edge  routers,  packets  are  labeled 
to  allow  routers  to  forward  their  traffic.  Additionally,  IntServ  packets  will  be  inserted 
flow  state  information,  which  is  then  used  and  updated  by  the  state-less  high-speed  core¬ 
routers  when  processing  and  forwarding  traffic. 
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III.  EFFICIENT  RESOURCE  MANAGEMENT 


Chapter  II  introduced  the  concept  of  resource  management  and  explained  its  key 
role  for  future  networks.  Admission  control,  resource  allocation  and  link-sharing  were 
identified  as  the  building  blocks  for  the  activity  of  managing  network  resources  in 
forthcoming  QoS  capable  networks.  This  chapter  builds  on  the  previous  chapter  to 
describe  an  efficient  and  dynamic  resource  management  model,  which  makes  uses  of 
those  mechanisms  to  meet  the  requirements  of  the  SAAM  network.  In  providing  support 
for  multiple  levels  of  QoS,  e.g.,  those  defined  by  the  IntServ  and  Difffierv,  a  novel 
concept  of  inter-service  borrowing  of  bandwidth  will  be  presented  as  a  solution  to 
provide  for  a  better  resource  management  in  such  QoS  networks. 

A,  RESOURCE  MANAGEMENT  APPROACHES 

The  current  implementation  of  SAAM  provides  for  multiple  services  classes,  each 
offering  one  or  more  levels  of  services.  These  service  classes.  Integrated  Service, 
Differentiated  Service  and  Best  Effort  Service,  will  concurrently  share  network  resources, 
e.g.  link  bandwidth.  If  the  goal  of  efficient  utilization  of  resources  is  to  be  met,  then 
SAAM  resource  management  must  ensure  that  each  service  level  takes  an  optimum  share 
of  network  resources  at  any  time,  in  order  to  maximize  resource  utilization.  The  sharing 
mechanism  needs  to  be  adaptive  so  that  it  adjusts  to  dynamic  loads  in  each  service  class. 
It  must  also  ensure  that  a  minimum  capacity  exists  at  all  times  to  fulfill  the  majority  of 
future  flow  demands  from  higher  priority  service  levels  like  IntServ  while  ensuring  that 
lower  service  levels  will  not  starve. 

The  complete  link-share  model  for  SAAM  is  depicted  in  Figure  3.1.  In  addition  to 
the  already  mentioned  IntServ,  DiflBerv  and  Best  Effort  service  levels,  the  model  also 
ensures  that  some  bandwidth  is  reserved  for  signaling  traffic,  i.e.  SAAM  control  traffic 
and  finally,  some  other  special  traffic,  named  out-of  profile  (OP).  OP  traffic  results  from 
misbehaving  user  applications  that  generate  traffic  in  excess  of  their  previously 
negotiated  QoS  guarantees.  In  such  cases,  offending  packets  are  marked  as  out-of-profile 
and  pushed  to  the  OP  service  level.  Typically,  OP  packets  receive  the  lowest  priority. 
They  are  forwarded  after  all  other  traffic,  i.e.,  when  the  link  would  be  otherwise  idle. 


11 


Link 


10%  40%  30%  20%  0% 

Figure  3.1  Link-share  model  in  SAAM 


1,  Initial  Resource  Allocation 

In  the  SAAM  network,  the  SAAM  server  is  responsible  for  the  resource 
allocation.  During  initial  startup  and  as  part  of  the  configuration  cycle,  participant  routers 
advertise  themselves  and  their  interfaces  to  the  SAAM  server,  which  in  turn  develops  the 
Path  Information  Base  (PIB).  The  PIB  is  a  data  structure  that  will  be  used  by  the  Server 
to  determine  all  possible  paths  among  all  network  nodes  and  to  maintain  link  status 
information,  as  reported  by  routers.  From  the  total  bandwidth  of  each  interface  as 
reported  by  the  hosting  router,  the  Server  then  allocates  a  predetermined  amount  to  each 
of  the  five  service  levels.  This  initial  bandwidth  is  called  base  allocation  per  service  level 
(BA)  and  is  represented  as  a  percentage  of  the  total  interface  bandwidth.  A  typical  link 
share  per  service  level  as  previously  used  by  SAAM  is  shown  in  Figure  3.2. 
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Figure  3.2  Typical  link  share  percentages  in  SAAM 
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The  share  assigned  for  the  SAAM  eontrol  ehannels,  is  vital  for  the  funetioning  of 
the  entire  SAAM  region.  As  a  goal  in  SAAM,  the  amount  of  eontrol  traffic  should  never 
be  higher  than  the  assigned  10%  of  the  total  bandwidth  in  each  link.  The  non-conforming 
traffic  of  OP  service  pipe  is  typically  given  no  bandwidth  share.  Consequently,  OP 
packets  are  only  served  at  each  router  when  no  other  traffic  is  waiting  for  service.  OP  is 
the  only  service  that  may  suffer  from  starvation  when  the  network  load  is  high.  Finally, 
the  share  among  the  remaining  three  service  levels  shall  then  be  assigned  to  fulfill  the 
business  and  administrative  goals  of  the  networking  service  being  provided,  in  an 
optimum  and  efficient  way. 

2,  Developing  an  Optimum  Share  Model 

Lets  consider  a  single  link  with  a  maximum  bandwidth  capacity  Cmax,  and  with 
five  service  levels  as  mentioned  before.  Considering  the  individual  capacities  Ccc,  Q, 
Cd,  Cb,  Cop,  assigned  respectively  to  SAAM  control  channels,  IntServ,  Difffierv,  BE  and 
OP  service  levels,  the  following  expression  holds: 

Ccc  +  C^  +  +  Cgp  +  Cqp  <  (3.1) 


Figure  3.3  Link  share  model  for  SAAM  with  conservative  base  allocation 

There  are  different  alternatives  for  the  distribution  of  the  link  share  among  the 
different  classes  of  service.  One  of  such  alternatives  could  be  performing  static 
allocation,  based  on  historical  data  and  statistical  models  to  forecast  future  load 
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distribution  for  all  service  classes.  While  this  solution  requires  the  least  effort  after  initial 
setup,  it  offers  no  flexibility  and  it  is  likely  to  result  in  poor  network  utilization.  At  some 
point,  one  service  level  may  be  using  its  entire  allocated  share  and  rejecting  or  buffering 
traffic  while  other  services  may  be  using  a  small  fraction  of  their  share,  thus  making  an 
inefficient  use  of  resources. 

A  different  approach  would  be  to  make  a  conservative  start  by  allocating  little  or 
minimum  capacity  for  each  of  the  service  classes,  which  results  in  some  of  the  link 
bandwidth  not  being  assigned  to  any  service  -  unallocated  bandwidth  (C^).  As  new 
network  users  are  admitted  to  the  different  classes  of  service,  the  utilization  of  each 
service  level  will  then  increase  and  eventually,  reach  the  maximum  initial  capacity 
available  for  the  class.  From  then  on,  the  resource  management  mechanism  ensures  that 
new  resource  demands  can  be  granted  by  claiming  the  initial  unallocated  capacity  as  long 
as  there  is  still  some  available.  The  same  way  classes  of  service  are  allowed  to  claim 
unallocated  bandwidth  as  needed,  they  should  also  release  that  bandwidth  as  soon  as  it  is 
no  longer  required,  thus  making  it  available  to  other  service  classes.  By  dynamically 
resizing  the  capacity  allocated  for  a  service  class,  the  network  automatically  adjusts  to  the 
profile  of  the  traffic  load,  which  increases  the  overall  network  utilization. 

The  previous  approach  may  be  further  extended  to  achieve  event  better  network 
utilization.  In  some  cases,  a  heavily  loaded  service  level  (say  IntServ)  may  be  using  all  of 
its  base  allocation  and  the  entire  link  unallocated  capacity  while  another  service  class 
(say  DiflServ)  is  using  only  a  small  fraction  of  its  base  allocation.  Intuitively,  if  the 
possibility  for  a  dramatic  increase  of  Difffierv  traffic  in  the  near  future  is  remote,  then 
some  fraction  of  Difffierv’s  unused  base  allocation  bandwidth  could  be  made  available 
for  borrowing  by  IntServ.  This  solution  would  yield  even  better  link  bandwidth 
utilization  and  decrease  the  total  number  of  rejections  of  user  flow  requests,  especially 
under  high  network  loads.  This  novel  approach  is  named  Inter-service  Borrowing  and 
will  be  explained  in  detail  in  the  following  sections. 

B,  CONSERVATIVE  BASE  ALLOCATION 

The  previous  section  introduced  the  concept  of  a  conservative  start  for  allocating 
bandwidth,  which  in  turn  leads  to  some  fraction  of  the  link  capacity  not  being  allocated. 
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The  initial  inequality  as  expressed  in  equation  3.1  should  be  modified  to  inelude  the 
unallocated  capacity,  thus  turning  the  initial  equation  into 


r  =c 

^  ^  '-'CC  ^  ^BF  ^  '-'OP  ^  '-'1/  '-'rt 


where  Cu  refers  to  the  unallocated  capacity. 

At  this  point,  it  is  of  interest  to  differentiate  the  concept  of  initial  allocation  (base 
allocation)  and  current  allocation.  Base  allocation  will  be  denoted  by  Cxo  (for  service 
class  X)  and  is  a  constant  value  that  is  assigned  on  network  startup  as  opposed  to  Cx 
which  is  the  current  allocated  value  for  service  X.  The  current  allocation  value  varies  over 
time,  depending  on  the  load  of  the  respective  service,  and  is  initially  set  equal  to  the  base 
allocation  Cxo,  i-O.,  at  the  startup  the  following  two  equalities  exist: 

C,  =  C,  for  IntServ 

‘O  ^ 

^Do  ~^D  forDiflBerv 

According  to  the  SAAM  model,  some  of  the  services  will  have  a  constant  share  of 
the  link  bandwidth.  We  will  therefore  assume  that  SAAM  control  channel  and  Best  Effort 
services  will  have  a  fixed  share  allocation  over  time^.  Additionally,  Out  of  Profile  traffic 
will  have  no  capacity  specifically  allocated  and  therefore  Cqp  =  0. 

Based  on  the  above  assumptions,  the  initial  setup  of  the  network  is  therefore 
performed  in  accordance  with  the  following  equation: 

C,,  +  +  Qc  +  +  Q  =  C_ .  (3.2) 


With  the  assumption  that  Ccc  and  Cbf  remain  constant  over  time,  let  us  isolate 
three  dynamic  terms  of  interest  of  this  discussion.  It  will  be. 


C  +C  +C 

'-'/O  ^  '-'Do  ^  '-'U 

c  +c  +c 
c  +c  +c 

^  lo  ^  '-'Do  ^  '-'(/ 


=  Qax-(Qe+C,^) 
=  C' 


IntServ  and  DiflServ  classes  of  service  will  use  network  resources  on  demand. 
The  initial  capacity  allocated  for  these  two  classes  (C/o  and  Cdo)  may  be  used  either 

2  An  alternative  for  BE  in  SAAM,  may  be  the  utilization  of  unused  capacity  allocated  for  Control 
Channels,  IntServ  and  DiffServ.  This  could  be  achieved  with  a  work-conserving  packet  schedule  algorithm. 
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partially  or  totally.  Whenever  any  of  these  classes  use  their  base  allocation  share,  they 
become  eligible  for  taking  some  of  the  unallocated  capacity  as  required.  Eventually,  no 
more  unallocated  space  is  available,  which  is  then  the  case  to  try  inter-service  borrowing, 
between  these  two  classes.  The  next  section  will  address  this  sequence  in  detail. 

C.  ADMISSION  CONTROL  SEQUENCE 

As  suggested  in  the  previous  section,  the  process  of  dynamic  resizing  the 
bandwidth  assigned  to  a  service  level  goes  through  a  sequence  of  different  phases.  This 
readjusting  process  is  triggered  by  the  arrival  of  a  new  IntServ  or  DiflServ  flow  request 
and  is  part  of  the  admission  control  mechanism.  The  admission  control  procedure  can  be 
divided  in  three  distinct  steps,  each  corresponding  to  a  distinct  admission  phase,  as 
illustrated  in  figure  3.4,  and  they  are: 

•  Step  1  -  Direct  admission 

•  Step  2  -  Dynamic  growing 

•  Step  3  -  Inter-service  borrowing 


Flow  Request 


Direct  Admission? 


Dynamic  Growing? 


Dynamic  Growing? 


Reject 

Flow 


Yes 
Admit  Flow 


Yes 
Admit  Flow 


Yes 
Admit  Flow 


Figure  3.4  Admission  control  sequence. 

1,  Direct  Admission  -  Admission  Step  1 

Direct  admission  is  the  first  phase  of  the  admission.  It  is  the  most  basic  admission 
control  step,  because  a  single  service  class  is  considered.  A  new  flow  is  admitted  at  this 
point  if  there  is  enough  available  bandwidth  from  the  initial  base  allocation  for  that 
service.  All  new  flow  requests  go  through  this  phase.  If  admission  fails  at  this  stage,  it 
means  the  service  load  has  increased  over  the  initial  base  allocation  for  the  service  and 
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the  flow  request  must  therefore  proeeed  to  phase  2.  Reeall  that  variables  C/  and  Cd 
represent  the  eurrent  alloeated  eapaeity  for  IntServ  and  Difffierv,  respectively.  As  already 
stated,  initially  we  have: 

C,  =  Q,  and 

Let’s  now  consider  the  sequence  of  steps  required  to  admit  a  new  flow  request. 
For  simplicity  and  without  loss  of  generality,  it  is  assumed  that  new  flow  request  belong 
to  IntServ.  Only  two  classes  of  services  will  be  considered:  IntServ  and  DiflServ. 
However,  the  following  deduction  could  easily  be  extended  to  n  different  classes  of 
services.  Considering  that  a  new  flow  request/^  arrives  and  has  a  bandwidth  requirement 
of  Rj*,  the  admission  criteria  for  this  flow  is  based  on  the  equation 

Y,Rf+Rr^cCiC,  (3.3) 

where  Bi  is  the  set  of  currently  active  flows  of  service  I  (IntServ). 

Equation  3.3  introduces  also  the  factor  «/,  which  is  referred  to  as  the  load  factor 
for  IntServ.  Typical  network  load  management  uses  this  load  factor  to  prevent  maximum 
load  to  approach  the  full  physical  link  capacity.  Although  the  actual  value  for  this  factor 
is  not  relevant  for  the  present  discussion,  it  is  included  in  the  expressions  herein 
presented  for  completeness.  Since  0  <  ai<  1,  we  can  at  most  use  aiCi  capacity  which  is 
less  than  or  equal  to  C/.  Whenever  inequality  3.3  holds  then  the  new  flow/^  may  be 
admitted  and  the  admission  procedure  does  not  need  to  go  into  next  step. 

2.  Dynamic  Growing  -  Admission  Step  2 

Dynamic  growing  refers  to  the  ability  for  the  link  share  mechanism  to 
dynamically  adapt  to  changing  service  level  load.  By  starting  with  a  conservative  small 
base  allocation  of  bandwidth  for  each  of  the  service  levels,  this  step  ensures  that  each 
service  is  allowed  to  received  more  resources  from  the  unallocated  capacity,  only  when 
they  need  them.  Inversely,  when  those  resources  are  no  longer  required  for  that  service, 
they  are  released,  thus  made  available  for  other  services.  Suppose  inequality  3.3  is  not 
satisfied  during  the  previous  step.  It  means  that  there  is  not  enough  capacity  C/  to  satisfy 
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the  new  request.  This  next  step  now  will  attempt  to  use  some  of  the  possible  unalloeated 
eapaeity.  The  admission  eondition  then  beeomes 

Y,Rf+Rr<aXc^+pC,)  (3.4) 

ft^B, 

The  differenee  from  equation  3.3  is  that  we  now  try  to  inerease  C/  by  a  small 
amount,  enough  to  aeeept  the  new  flow  request.  Intuitively,  we  need  both 

Cy  >  0  and  >  0 

The  amount  of  unalloeated  bandwidth  elaimed  to  satisfy  the  new  request  should 
be  minimum.  Therefore,  from  inequality  3.4  we  ean  derive  the  optimal  value  for  ji  as 
follows: 

'^Rf  +  Rf*  =  cc,Cj  +a,pCu  (3.5) 

^^Rf  ~^Rf*  ~0CjCi 
- 

a  C 

The  new  flow  may  then  admitted  if: 

Q>0 

and 

O<y0<l 

In  the  ease  of  =  1,  the  new  flow  is  admitted  taking  all  of  the  unalloeated 
eapaeity.  After  admission,  the  bandwidth  alloeation  for  IntServ  is  inereased  by  a  given 
amount  and  the  unalloeated  eapaeity  is  decreased  by  the  same  amount.  Respective 
variables  must  be  updated  in  the  following  order: 

c,=c,+pc^ 


c^=c,-pc^ 

By  doing  this,  we  are  enabling  dynamic  growing  of  the  total  link  share  for  a  given 
class  of  service,  which  may  happen  as  long  as  there  is  enough  unallocated  space. 
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Whenever  it  is  no  longer  possible  to  dynamically  grow  this  way,  the  admission  procedure 
proceeds  to  step  3. 

3.  Inter-service  Borrowing  -  Admission  Step  3 

Inter-service  borrowing  is  to  be  considered  only  when  the  load  of  one  service 
level  peaks  and  other  services  are  not  using  their  entire  base  allocated  bandwidth.  When 
the  load  of  a  given  service  level  is  very  high,  it  is  possible  that  the  sum  of  the  base 
allocation  with  the  unallocated  space  is  not  enough  to  fulfill  the  resource  demand  for  that 
service.  In  such  case,  the  admission  process  fails  both  phase  1  and  phase  2  steps. 
However,  under  some  circumstances  it  might  be  possible  to  borrow  some  capacity  from 
other  services.  This  inter-service  borrowing  mechanism  is  based  on  a  statistic  model  for 
the  network  traffic  and  will  be  explained  in  the  next  section.  For  now,  it  matters  only  to 
focus  on  the  new  admission  condition  applicable  to  this  last  case. 

The  admission  condition  for  phase  2  -  equation  3.4  -  now  no  longer  holds. 
Providing  that  some  capacity  can  be  borrowed  from  some  other  service,  that  borrowed 
bandwidth  should  be  added  to  the  right  side  of  equation  3.4,  which  then  becomes: 

PdCd)  (3-6) 

In  equation  3.6,  C/  refers  to  the  current  total  allocation  for  the  service  I  (IntServ), 
pCu  is  the  available  unallocated  capacity,  and  finally,  PdCd  represents  the  maximum 
bandwidth  that  service  D  (DifiServ  in  this  case)  makes  available  for  inter-service 
borrowing.  It  is  important  to  note  that  at  this  stage  in  the  admission  process,  the 
unallocated  capacity  Cu  is  either  zero  or  very  small,  and  is  insufficient  to  meet  the  new 
flow  requirement.  That  remaining  capacity  should  therefore  be  completely  used  before 
going  into  inter-service  borrowing,  which  explains  the  pCu  in  equation  3.6.  For  this 
reason,  P=1  and  the  admission  condition  can  me  modified  to  become: 

X^,+^/.Sa,(C,+C„+/0„C„J  (3.7) 

This  new  equation  differs  from  equation  3.5  by  the  new  term  pdCdo,  where  Cdo  is 
the  base  allocation  for  service  D  (DifiServ)  and  po  the  fraction  of  that  capacity  that  might 

be  borrowed.  Since  the  base  allocation  for  DifiServ  is  constant,  the  solution  for  the 
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inequality  depends  upon  the  value  of  pu.  As  already  stated,  next  section  will  detail  a  way 
of  calculating  po.  For  now,  assume  that  we  have  obtained  a  value  for  po.  With  this  value, 
either  the  equation  does  not  hold  and  the  new  flow  request  is  rejected,  or  instead,  the  new 
flow  can  be  admitted. 

If  the  new  flow  is  accepted,  inter-class  borrowing  takes  place.  For  instance,  using 
the  previous  example,  it  would  mean  that  Difffierv  has  its  available  bandwidth  partially 
reduced  until  resources  are  released.  In  order  to  keep  track  of  this  capacity  transfer, 
variables  C/  and  Cd  must  be  updated  to  reflect  the  new  allocation  transfer.  The  bandwidth 
transfer  from  Difffierv  to  IntServ  in  this  example  should  be  no  more  than  the  necessary  to 
admit  the  new  flow.  This  means  that  we  are  interested  in  the  minimum  value  for  po  that 
satisfies  the  inequality  3.7,  i.e. 

-min(p^) 
such  that, 

“^/(^/  +^1/  P'd  ^d)  (3-8) 

f^Bi 


Expressing  p  ’  as  the  dependent  variable,  equation  3.8  becomes: 


Pd  = 


f<^B, 


cc^C  L 


Cj+C, 

Cn 


(3.9) 


After  the  admission  of  the  new  flow,  the  allocation  variables  should  be  updated  as 


follows: 


Cu=0 


C^=C^-p^'C^ 

D,  INTER-SERVICE  BORROWING  EXPLAINED 

If  the  network  load  were  easily  predictable  and  constant,  it  would  be  possible  to 
adjust  the  resource  shares  of  different  service  levels,  in  an  optimum  way,  such  that  the 

resource  utilization  would  be  maximum  and  the  flow  rejection  rate  minimum.  However, 
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in  the  real  world,  this  is  never  the  ease  and  there  is  always  some  uneertainty  on  traffie 
predietion.  Traffie  load  fluetuations  are  more  than  likely  and  therefore  the  resouree 
management  algorithm  should  be  dynamic  and  adaptive,  in  order  to  maximize  resource 
utilization  and  ensure  availability,  even  when  network  load  is  unbalanced  among  service 
levels.  Inter-service  borrowing  seems  a  logic  step  in  this  regard. 

1,  Aggregated  Flow  Distribution 

As  discussed  in  the  previous  section,  the  three-step  admission  procedure  relies  on 
inter-service  borrowing  at  last,  to  admit  a  new  flow  at  extreme  load  levels.  The  admission 
condition  for  inter-service  borrowing  (equation  3.7)  shows  that  the  admission  decision  is 
a  function  of  the  coefficient  p,  defined  as  the  required  fraction  of  the  base  bandwidth 
allocation  of  the  service  level  to  borrow  from.  A  service  should  make  available  some  of 
its  base  allocation  capacity  only  when  there  is  a  minimal  probability  for  that  service  to 
use  that  capacity  in  the  near  future.  The  basic  idea  is  to  obtain  some  quantitative  measure 
of  the  bandwidth  that  a  service  can  make  available  for  borrowing,  without  reducing  much 
of  its  own  ability  to  accept  new  flows. 

Consider  that  network  clients  request  flows  with  different  throughput 
requirements.  We  may  assume  that  the  throughput  requirements  of  individual  flows 
follow  some  type  of  unknown  distribution  with  the  following  characteristics: 

jLlg  -  mean  value  of  an  individual  flow  request 

(Jq  -  standard  deviation  of  the  flow  request  distribution 

If  we  now  consider  that  {Ri,  R2,  Rs,  ....  Rn)  is  a  random  sample  from  the  above 
distribution  and  that  they  represent  at  any  time,  the  individual  throughputs  of  n  active 
flows,  then: 

R  is  the  mean  value  of  the  sample. 

According  to  the  Central  Limit  Theorem  [6],  R  is  approximately  a  normal 
distribution  with: 

e(r)=Rj=R,  (mean) 
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F(i?)=cr|=—  (variance) 

n 

a-  =  (standard  deviation) 

yjn 

The  total  throughput  T  of  the  set  of  n  aetive  flows  is  the  sample  total  and  can 
easily  be  obtained  by  the  equation  bellow: 

n 

1=1 


and 

E{t)  =  nE{R)=  np^ 

(expeeted  mean  value  for  total  throughput) 

V(r)  =  nv{p)=na^ 

(expected  variance) 

(Tj.  =  ^fn<T^ 

(standard  deviation) 

2,  Probabilistic  Bandwidth  Utilization 

Now  consider  that  the  number  of  flows  n  is  constant  and  that  the  throughput 
requests  of  individual  flows  follow  the  same  distribution  with  mean  /it  and  standard 
deviation  aj.  For  any  given  probability  p,  we  are  now  interested  to  obtain  a  value  x  such 
that 

p{r  <x)= p . 

So,  it  will  be 


CTt  ) 


O 


X- 

(J  rp 


=  P 


o 

V 


yfncTo  ^ 


=  P 
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|JT  =  n.|Jo  X 


Throughput 


Figure  3.5  Aggregated  throughput  distribution  as  a  normal  distribution.  Total 
throughput  T  of  all  n  active  flows  is  less  than  x  with  a  probability  p. 


As  an  example,  lets  consider  a  probability  p  =  0.9495  ~  95%. 
We  then  have 


f 

O 

V 


Vncr„  ^ 


0.9495 


yfncTo 


1.64 


x  =  np^ 


+ 1. 64  Vncr^ 


(3.10) 


or 

x  =  pj^+l.64aj  (3.11) 

Equations  3.10  and  3.11  allow  us  to  obtain  a  value  of  x  based  on  the  probability  of 
95%.  Different  values  could  be  selected.  Depending  on  what  data  is  available,  either 
equation  might  be  used.  For  instance,  if  we  precisely  know  the  mean  flow  request,  the 
standard  deviation  of  the  distribution  of  those  flow  requests  and  the  number  of  active 
flows,  equation  3.10  is  to  be  used.  If  otherwise  we  know  nothing  about  the  original  flow 
distribution  or  if  the  number  of  flows  is  not  exactly  known,  we  may  otherwise  have  to  use 
equation  3.11. 
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3. 


A  Scalable  Soft-State  Solution  for  SAAM 


One  of  the  underlying  goals  of  SAAM  is  to  keep  the  minimal  network  status 
information,  i.e.  maintain  a  soft  state,  thus  providing  for  robustness  and  sealability, 
without  too  much  increase  of  complexity.  For  instance,  once  new  flows  are  admitted,  no 
information  is  kept  with  regard  to  the  actual  number  of  active  flows.  In  equation  3.10,  x  is 
expressed  as  a  function  of  the  number  of  active  flows  and  therefore  this  equation  cannot 
be  used  in  SAAM.  The  only  alternative  is  equation  3.11,  which  expresses  x  as  a  function 
of  the  two  parameters  jir  and  ot,  that  characterize  the  distribution  of  the  total  throughput 
T. 

We  can  estimate  jir  with 

Mt  ~  ’ 

f^B 

where  B  is  the  set  of  currently  active  flows  of  this  service  class.  Equation  3.11  now 
becomes 

x  =  ^i?/ +1.640-^  (3.12) 

/eB 

The  SAAM  server  continuously  receives  link  state  information  from  routers.  This 
information  contains  not  only  bandwidth  utilization  per  class  of  service  but  also  other 
QoS  metrics  like  data  delay  and  data  loss  rate.  This  soft  state  approach  decreases  the 
complexity  at  the  core  routers  because  no  state  information  is  maintained  at  flow  level. 
No  mechanism  to  explicitly  notify  network  about  termination  of  a  flow  exists.  In  fact, 
once  a  new  flow  is  admitted  and  resources  are  reserved  accordingly,  the  process  of 
releasing  those  resources  is  implicitly  part  of  the  periodic  link  state  advertising.  The 
central  SAAM  server  only  maintains  updated  information  about  the  throughput  of  the  set 
of  active  flows  for  each  router  interface.  Consequently,  the  term  is  easily  obtained 

JeB 

for  every  class  of  services.  However,  in  3.11  we  still  have  the  unknown  standard 
deviation  parameter  of  the  flow  aggregate  distribution.  With  the  knowledge  of  the 
number  of  active  flows  and  the  characteristics  of  the  individual  flow  request  distribution, 
it  would  be  straightforward  to  compute  the  standard  deviation.  However,  since  we 
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assumed  to  know  nothing  about  the  number  of  flows  nor  about  the  original  distribution,  a 
different  approach  must  be  followed. 


Normal  Distribution 

|j=constant,  different  ol\i 


Figure  3.6  Normal  distribution  for  different  three  ratios  a/p. 

It  was  already  shown  that  the  total  throughput  distribution  and  the  individual  flow 
request  distribution  are  related  with  each  other  and  that  the  following  equations  apply; 

(jj.=4n(jQ  (3.13) 

and 


jUj=njUQ  (3.14) 

Dividing  equation  3.13  by  equation  3.14  we  obtain 

(jj  ^fn(7Q 


CT  Y  1  CT  Q 

Mt  yfn 


(3.15) 


It  is  reasonable  to  assume  that  some  information  is  known  about  the  profile  of  the 
individual  flow  requests.  From  past  data,  there  should  be  at  least  knowledge  about  the 
mean  value  of  the  bandwidth  request  per  flow.  However,  we  will  take  a  conservative 
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approach  by  assuming  that  we  only  know  something  about  the  shape  of  the  flow  request 
distribution,  i.e.  the  ratio  ao/^io- 


Ratio  oT  /  pT  vs  Number  of  flows 


Aggregate  Flow  Distribution  -  ctT  /  pT 


Figure  3.7  Ratio  ai/pr  versus  the  number  of  participant  flows  for  three  different 

shapes  of  flow  request  distributions. 

Figure  3.7  shows  a  graph  plotted  with  equation  3.15.  For  the  aggregated 
throughput  distribution,  the  number  of  flows  as  a  function  of  the  ratio  gt  /jJ-r,  for  three 
different  shapes  of  the  original  flows  request  distribution,  i.e.  for  the  ratios  aj/io  =  2,  1 
and  0.5. 

Lets  now  assume  that  the  standard  deviation  of  the  original  flow  distribution  is 
equal  to  its  mean,  i.e.  Go/ jUo=  1-  This  is  considered  a  conservative  approach  since  the  real 
distribution  is  likely  to  be  mueh  more  concentrated  about  the  mean,  i.e.  with  a  ratio  Gq/ jJio 
<  1.  Additionally,  it  is  assumed  a  substantial  number  of  active  flows,  for  example  n  = 
100.  Referring  to  the  graph  in  figure  3.7,  these  assumptions  apply  to  the  (0.1,100) 
coordinate  point,  marked  with  a  big  circle.  By  inspeeting  the  graph,  it  ean  be  observed 
that  as  the  number  of  flows  increases  or  the  Go  /  fio  ratio  decreases  (narrow  original  flow 
distributions)  the  ratio  gt  /ixt,  also  decreased.  With  the  given  assumption,  equation  3.14 
becomes 
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1 


CT  j 

Ht 


xl  =  0.1 


(Tj  =  OAjUj. 

We  can  now  replace  aj  in  equation  3.12,  which  becomes 
x=  +1.64x0.1//^ 

f^B 


and  finally  conclude  with; 
x= 


or 

x  =  1.164^i?^  (3.16) 

f^B 


In  summary,  when  the  number  of  active  flows  equal  or  exceeds  100,  and  the 
original  flow  request  distribution  satisfies  Go  <iUo,  we  can  ensure  with  a  certainty  of  95% 
that  the  throughput  requirement  of  this  service  class  will  not  exceed  the  value  x  as  given 
by  equation  3.16.  Figure  3.8  is  a  pictorial  representation  of  this  concept  applied  to  the 
Difffierv  class. 

As  discussed  in  the  previous  section,  the  admission  condition  for  inter-service 
borrowing  was  given  by 

^Rf  +  Rf»  <  ccj  {Cj  +  Q  +  ) 

f^B, 


The  term  pdCd  represents  the  maximum  capacity  that  can  be  borrowed,  can  now 
be  expressed  as  follows: 


Pd^d  ^ 


Pd^D 


D 


f 


+0.164X^, 

v/^^o  f^Ba  ) 


-1.164 

f^Bo 
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and  the  complete  admission  equation  becomes 


Rf»  ^  cc I  C I  +  C(y  +  cx 0  —1.1 64 


(3.17) 


f^Bo  y 

Equation  3.16  is  therefore  applicable  for  a  probability  of  95%  and  a  number  of 
active  flows  n>  100. 


Figure  3.8  Pictorial  representation  of  the  borrowing  capacity  of  DiffServ,  based  on 

the  probability  of  95%. 

E.  CHAPTER  SUMMARY 

QoS  capable  networks  and  the  consequent  need  for  resource  allocation  present 
new  challenges  for  the  efficient  use  of  network  resources.  The  link-sharing  mechanism 
allows  multiple  service  levels  to  share  the  same  link,  however  in  providing  such 
versatility,  dynamic  and  adaptive  share  mechanisms  must  be  used  in  order  to  preserve 
high  levels  of  resource  utilization.  The  concept  of  resource  management  described  in  this 
chapter,  allows  for  multiple  services  levels  to  adjust  their  link  share  by  dynamically 
resizing  their  allocated  capacity  and  using  the  unallocated  capacity  until  they  reach  an 
point  of  equilibrium,  which  self  adjusts  to  changing  network  load  conditions.  Moreover, 
by  means  of  inter-service  capacity  borrowing,  it  is  possible  to  further  enhance  resource 
utilization.  It  should  be  understood,  however,  that  the  complexity  associated  with  this 
resource  management  approach  only  makes  sense  because  it  is  assumed  that  network 
resources  are  limited  and  we  want  to  maximize  resource  utilization  levels.  Next  chapter 
will  detail  the  implementation  of  all  these  concepts  in  the  current  SAAM  prototype. 
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IV.  SAAM  QOS  MANAGEMENT  DESIGN 


In  the  previous  chapter,  the  theory  behind  the  new  advanced  resource 
management  concept  was  explained  in  detail.  As  the  main  component  of  the  SAAM 
server,  the  Path  Information  Base  (PIB)  defines  the  server  behavior  in  all  QoS 
management  tasks.  This  chapter  will  discuss  the  design  specifics  of  PIB  and  the  required 
changes  to  enable  inter-service  borrowing.  The  chapter  starts  by  first  describing  the 
overall  design  of  a  SAAM  server.  Then  the  PIB  and  its  main  functions  are  described  in 
detail.  Finally,  we  conclude  with  the  design  details  of  inter-service  borrowing  and  PIB  re¬ 
design  in  support  of  the  new  QoS  management  capabilities  of  SAAM. 

A.  THE  SAAM  SERVER 

1.  Overview 

The  basic  component  of  the  SAAM  prototype  is  the  SAAM  router.  In  its  simplest 
form,  the  SAAM  router  is  a  Java  based  application  that  uses  a  layered  architecture  to 
emulate  the  full  Internet  Protocol  stack  and  all  the  functionality  associated  with  a  SAAM 
router.  Java  multithreading  is  highly  used,  which  allows  all  different  emulated  router 
components,  to  function  in  parallel  and  to  establish  data  and  control  channels  among 
them.  Although  the  router  model  is  designed  to  work  over  current  IPv4  networks,  the 
current  version  of  the  SAAM  prototype  supports  only  IPv6.  The  emulated  physical  layer 
performs  the  bridge  interface  between  the  underlying  IPv4  infrastructure  and  the  IPv6 
SAAM  prototype. 

The  SAAM  server  is  an  extension  of  a  SAAM  router.  The  server  application 
resides  in  the  outer  layer  of  a  SAAM  router,  i.e.  the  application  layer  of  the  protocol 
stack.  That  router  is  then  able  to  perform  all  the  normal  functions  associated  with  a  router 
plus  all  tasks  specific  to  the  SAAM  server.  Figure  4.1  depicts  this  modularized  approach. 
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Layered  Architecture  of  a  SAAM  Router 


Figure  4.1  Layered  arehitecture  of  a  SAAM  router.  The  SAAM  server  is  a  SAAM 

router  with  a  resident  agent  application  that  performs  server  specific  operations. 

2,  Main  Functions  of  the  SAAM  Server 

The  server  model  was  originally  developed  by  NFS  graduates  Vrable  and  Yarger 
[7].  Since  then,  several  enhancements  have  been  made,  namely  the  introduction  of  the 
basic  QoS  management  capability  by  Queck  [3],  signaling  channels  by  Akkoc  [8], 
backup  server  functionality  by  Kati  [9],  and  dynamic  PIB  generation  by  Cheng  and 
Gibson  [2].  The  functions  of  the  current  SAAM  server  prototype  may  be  divided  into 
three  types  as  described  in  the  sections  that  follow. 

a.  Active  Network  Control 

When  the  server  first  initiates,  it  tries  to  establish  communication  with 
other  SAAM  players  (SAAM  routers  and  eventual  SAAM  backup  servers).  This  is  done 
during  the  initial  configuration  cycle,  by  sending  special  control  messages  through  all 
server  interfaces.  Routers  in  turn  will  receive  this  message  and  continue  flooding  the  rest 
of  the  network  until  edge  routers  are  reached.  This  initial  configuration  cycle  closes  with 
messages  being  exchanged  among  routers  and  back  to  the  server.  When  the  initial  cycle 
is  complete,  all  participating  routers  will  have  registered  the  presence  of  a  server  in  the 
region  and  updated  their  routing  table  to  create  signaling  channels  for  forwarding  control 
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traffic  from  and  to  the  server  [8].  Aetive  network  eontrol  involves  also  seeurity  related 
tasks  like  authentieation  and  integrity  proteetion  of  eontrol  traflio  [9]. 

b.  Topology  Management 

After  the  initial  startup  phase  and  when  all  signaling  ehannels  have  been 
established,  partieipating  routers  will  then  take  the  initiative  of  reporting  their  eapaeities 
to  the  server  by  sending  Link  State  Advertisement  (LSA)  messages.  The  first  LSA  sent 
by  a  router  typieally  deseribes  the  physieal  eharaeteristies  of  eaeh  of  its  interfaees, 
ineluding  the  IPv6  address  and  assoeiated  link  bandwidth.  As  the  server  proeesses  LSA 
messages  from  routers,  it  ereates  an  image  of  the  network  by  aggregating  all  pairs  of 
eonneeted  interfaees  into  point-to-point  links  and  diseovering  all  possible  path 
eombinations  from  these  links.  During  normal  operation,  the  topology  may  dynamieally 
ehange  as  interfaees  are  added  or  removed  through  LSA  messages. 

c.  QoS  Resource  Management 

Resouree  management  is  the  main  and  most  work-intensive  funetion  of  a 
SAAM  server.  It  refers  to  those  server  aetions  direetly  related  with  maintaining  the 
performanee  status  of  all  links  in  its  region,  the  resouree  reservation  and  user  admission 
eontrol. 

B,  THE  PATH  INFORMATION  BASE 

As  the  eentral  repository  of  information  about  all  paths  eonneeting  pairs  of  routers 
in  the  SAAM  region,  the  Path  Information  Base  (PIB)  is  the  eore  eomponent  of  the 
SAAM  server  and  is  one  of  the  most  important  modules  of  the  SAAM  arehiteeture.  The 
basie  design  details  of  PIB  have  been  doeumented  in  [2].  The  PIB  exehanges  information 
with  the  network  by  means  of  four  SAAM  speeifie  messages.  Two  of  these  messages,  the 
link  status  advertisement  (LSA)  and  the  flow  request  messages  are  inbound  messages  and 
forwarded  by  the  server  agent  to  the  PIB  module.  In  response  to  eaeh  flow  request 
message  of  a  elient  applieation,  the  PIB  sends  a  flow  response  message  to  the  elient  and 
under  some  eonditions,  a  routing  update  message  to  the  relevant  routers.  Both  messages 
are  generated  within  the  PIB  module  and  sent  to  the  hosting  server,  whieh  in  turn 
forwards  them  to  the  destination  routers.  Figure  4.2  shows  the  basie  input/output  of  PIB 
as  deseribed  above. 
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Path  Information  Base  -  PIB 

Basic  Input-  Output 


Link  Status  Advertisment  Msg 


Flow  Request  Msg 


Configuration  Information 


Status  and  performance 

•  Network  load 

•  Rejection  data 

•  QoS  performance  data 


Routing  Updates  Msg 


Flow  Response  Msg 


► 

► 


•  Link  Share  Model 

•  Inter-service  borrowing 

•  Routing  algorithm 


•  Network  load  factor 

Figure  4.2  The  basic  input/output  channels  in  the  Path  Information  Base 

In  addition  to  the  message  exchanges  during  normal  network  operations,  the  PIB 
may  accept  configuration  information  during  initial  startup  and,  report  network  status  and 
performance  data  to  an  external  module.  That  external  module  could  be  part  of  a  network 
management  tool  that  is  capable  of  sending  set  or  query  commands  to  the  PIB,  either 
remotely  through  especial  SAAM  messages  or  locally  by  conventional  console  access. 
An  example  of  such  commands  would  be  to  turn  inter-service  borrowing  on  or  off.  The 
development  of  such  functionality  is  not  part  of  this  study  and  is  left  for  future  work. 

Figure  4.3  shows  the  different  functional  blocks  within  PIB  and  the  interactions 
among  them.  Those  functional  modules  may  are  organized  about  two  different  functional 
goals;  topology  management  and  resource  management. 

1,  Topology  Management 

Topology  management  refers  to  the  ability  of  PIB  to  discover  the  topology  of  the 
SAAM  region  and  maintain  status  information  about  all  links.  As  shown  in  the  top  block 
of  figure  4.3,  it  is  achieved  by  processing  LSA  messages  that  the  PIB  receives  from 
supported  routers.  Each  LSA  contains  smaller  chucks  of  information  called  Interface 
State  Advertisement  (ISA),  each  one  associated  with  one  of  the  interfaces  of  the  reporting 
router.  A  single  ISA  may  be  of  typeADD,  REMOVE  or  UPDATE,  in  order  for  the  PIB  to 
respectively  add  a  new  interface,  remove  an  existing  interface  or  update  the  interface 
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status.  The  interface  status  data  maintained  by  PIB  are  those  that  are  relevant  for 
providing  QoS  guarantees  as  defined  in  SAAM,  i.e.  the  physical  link  bandwidth,  and  the 
link  bandwidth  utilization,  average  queuing  delay  and  packet  loss  rate  per  service  level  as 
observed  and  advertised  by  the  hosting  router. 


Path  Information  Base  -  PIB 

Functional  Block  Diagram 


Figure  4.3  The  main  functional  blocks  of  PIB. 

As  the  PIB  adds  or  removes  interfaces,  it  dynamically  regenerates  the  topology 
associated  with  its  SAAM  region  and  rearranges  the  collection  of  possible  paths 
interconnecting  supported  routers. 

2,  QoS  Management 

When  an  interface  is  first  advertised,  the  PIB  records  its  hosting  router  id,  the 
physical  bandwidth,  its  IPv6  based  identification  and  the  information  about  the  neighbor 
interface,  as  derived  from  both  the  neighbor  router  id  and  the  number  of  bits  of  the  subnet 
mask.  The  total  interface  bandwidth  is  then  partitioned  into  smaller  portions  and  assigned 
to  individual  service  levels  in  accordance  with  the  SAAM  service  model.  The  current 
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SAAM  prototype  supports  five  different  serviee  levels  -  IntServ,  DiffServ,  Best  Effort, 
Out  of  Profile  and  SAAM  eontrol  ehannel. 

a.  Interface  Information  in  PIB 

As  already  stated,  each  interface  in  PIB  maintains  information  about 
observed  QoS  per  service  level  (e.g.  observed  utilization,  delay  and  loss  rate),  which  are 
periodically  refreshed  by  LSAs  containing  ISAs  of  type  UPDATE.  Based  upon  the  QoS 
data  and  the  allocated  bandwidth  per  service  level,  the  PIB  also  computes  and  stores  the 
available  bandwidth  per  service  level.  Since  the  available  bandwidth  depends  on  the 
utilization  level  as  reported  by  routers,  it  should  be  recalculated  every  time  the  utilization 
level  changes  for  each  of  the  service  level. 

b.  Path  Information  in  PIB 

As  new  interfaces  are  added  to  PIB,  new  paths  are  also  created.  Each  path 
element  in  the  PIB  contains  a  unique  16-bit  integer  based  path  id,  the  sequence  of 
outbound  interfaces  the  path  traverses,  and  the  path’s  QoS  properties  in  terms  of 
maximum  available  bandwidth,  the  bound  on  end-to-end  packet  delay  and  packet  loss 
rate.  Each  path  QoS  property  can  be  expressed  as  a  function  of  the  same  QoS  property  of 
each  interface  traversed  by  the  path.  While  the  packet  delay  bound  and  the  loss  rate  of  the 
path  are  the  summation  of  the  delay  bounds  and  loss  rates  of  the  interfaces  respectively, 
the  path  available  bandwidth  is  the  minimum  available  bandwidth  among  all  interfaces, 
i.e.  the  available  bandwidth  of  the  bottleneck  interface. 

c.  Processing  a  Flow  Request 

When  processing  a  new  flow  request,  the  first  step,  which  is  common  to 
all  requests,  is  to  ensure  that  source  and  destination  nodes  are  physically  connected,  i.e., 
there  is  a  path  in  PIB  connecting  the  two  nodes.  If  the  destination  is  unreachable  from  the 
source,  then  the  client  application  will  be  notified  via  a  flow  response  message. 
Otherwise,  depending  upon  the  type  of  request,  the  admission  sequence  follows  a 
different  procedure  as  described  below. 

The  simplest  admission  sequence  applies  for  best  effort  flow  requests.  In 
this  case,  among  all  paths  available  from  the  source  to  destination,  the  admission  control 
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module  selects  one  of  them  in  accordance  with  the  predefined  path  selection  scheme.  For 
best  effort,  no  resources  need  to  be  reserved,  however,  if  the  path  has  not  yet  been  set  up, 
the  resource  reservation  module  ensures  the  routing  tables  at  each  router  the  path 
traverses  are  updated  before  the  affirmative  flow  response  is  sent  back  to  the  requestor. 

The  admission  sequence  for  IntServ  and  DiffServ  are  similar  with  the 
exception  that  DiffServ  requires  the  additional  identification  of  the  network  customer 
running  the  client  application  and  the  confirmation  of  his  Service  Level  Agreement  with 
the  network  [3].  The  specifics  of  the  agreement  and  thus  the  design  of  this  admission  step 
depend  upon  the  service  model  supported.  For  both  IntServ  and  DiffServ  the  next  step 
will  then  be  the  selection  of  a  path  that  meets  the  QoS  requirements  of  the  new  flow.  At 
this  stage,  the  admission  control  unit  of  PIB  simply  compares  the  QoS  requirements  of 
this  new  flow  with  the  QoS  properties  of  all  feasible  paths  to  determine  the  most  suitable 
path.  The  searching  strategy  is  dictated  by  the  selected  routing  scheme  (i.e.,  the  specific 
criteria  for  determining  the  most  suitable  path)  and  by  the  eventual  need  to  perform  inter¬ 
service  borrowing.  Once  the  path  is  selected,  the  resource  reservation  module  of  PIB  then 
ensures  that  the  PIB  state  is  updated  appropriately  to  reflect  the  fact  a  set  of  interfaces 
have  just  set  aside  a  portion  of  their  resources  to  support  the  new  flow.  This  update 
process  directly  involves  changes  to  the  QoS  properties  of  the  path  to  which  the  flow  is 
admitted  and  potentially,  of  other  paths  that  traverse  common  outbound  interfaces. 
Furthermore,  when  a  flow  is  admitted  through  inter-service  borrowing,  the  update 
process  must  be  duplicated  across  the  two  service  levels  involved.  Finally,  a  flow 
response  message  is  sent  to  the  client  application.  The  response  is  either  a  flow  approval 
containing  the  designated  flow  label  that  the  client  application  must  use  to  mark  its 
packets,  or  a  flow  rejection  indicating  that  no  path  can  meet  the  QoS  requirements  of  the 
flow  request. 

d.  Path  Selection  and  QoS  Routing 

Path  selection  refers  to  choosing  the  best  path  among  all  feasible  paths  that 
are  able  to  support  the  QoS  parameters  as  specified  in  the  flow  request.  There  are 
different  approaches  to  QoS  routing  [3];  Widest-Shortest  Path  (WSP),  Shortest-Widest 
Path  (SWP)  and  Shortest-Distance  Path  (SDP).  SWP  emphasizes  on  preserving  network 
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resources  by  selecting  a  shortest  path  while  WSP  provides  for  load  balancing  by  first 
selecting  widest  paths.  Due  to  time  constraints,  the  analysis  of  the  most  appropriate 
schema  is  left  for  future  research.  For  the  purpose  of  this  thesis,  the  selected  approach  is  a 
simplified  version  of  the  SWP  to  what  we  call  First  Shortest  Path  (FSP).  The  current  PIB 
stores  paths  with  the  same  source  and  destination  nodes  in  one  array  sorted  in  the 
increasing  order  of  their  hop  counts.  FSP  yields  the  best  possible  searching  time  by 
retrieving  the  first  path  in  the  array  that  meets  the  QoS  requirements  of  the  flow  request. 
When  inter-service  borrowing  is  enabled  and  regardless  of  the  route  selection  schema, 
inter-service  borrowing  should  only  be  considered  after  all  paths  in  the  array  have  been 
evaluated  first  without  considering  inter-service  borrowing. 

C.  INTER-SERVICE  BORROWING  DESIGN 

The  underlying  theory  for  inter-service  borrowing  was  already  discussed  in  the 
previous  chapter.  Inter-service  borrowing  only  has  to  do  with  resource  management  thus 
all  changes  made  to  the  SAAM  prototype  to  enable  inter-service  borrowing  were 
confined  to  the  PIB  module.  The  following  sections  describe  the  design  specifics  of  inter- 
service  borrowing. 

1.  Inter-service  Borrowing  at  the  Interface  Level 

It  was  previously  stated  that  PIB  maintains  two  types  of  QoS  data  per  service 
level;  observed  QoS  as  reported  by  routers,  and  available  bandwidth  as  calculated  within 
the  PIB.  Figure  4.4  below  illustrates  the  typical  bandwidth  partitioning  within  one  of  the 
service  levels  participating  in  inter-service  borrowing  (DiffServ  in  this  example). 
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Inter-Service  Borrowing 

Bandwidth  partitioning  with  inter-service  borrowing 


Diff  Serv  base  bandwidth  allocation 


► 


.DiffServ  current  utilization 


-DS  borrowing  threshold 


^IS  borrowed. 

■4 — Borrow  capacity- 
Available  for  DiffServ  — ^ 

- Max.  borrowing  capacity 


Figure  4.4  Bandwidth  partitioning  within  a  single  serviee  level  that  partieipates  in 
inter-service  borrowing  (DiffServ  in  this  example). 


The  whole  bar  represents  the  bandwidth  base  allocation  initially  assigned  to 
DiffServ.  The  current  DiffServ  utilization  is  shown  in  red  on  the  left,  indicating  that  the 
service  is  under-utilizing  its  allocated  bandwidth,  thus  suggesting  that  some  capacity 
could  be  made  available  for  inter-service  borrowing.  On  the  right  side  of  the  bar,  it  is 
observed  that  IntServ  is  already  borrowing  some  capacity  from  DiffServ  (dark  green). 
The  capacity  made  available  for  IntServ  is  calculated  within  PIB  as  a  function  of  the 
DiffServ  current  utilization  and  the  borrowing  threshold,  i.e.,  the  maximum  capacity  that 
might  be  made  available  for  borrowing.  During  the  admission  control  sequence,  only 
some  of  these  quantities  are  of  interest.  For  instance,  for  admitting  a  DiffServ  flow 
through  this  interface,  it  suffices  to  know  the  bandwidth  availability  of  DiffServ.  When 
performing  the  admission  control  for  IntServ,  it  only  matters  to  know  the  borrowing 
capacity  of  DiffServ  and  the  amount  previously  borrowed.  With  these  assumptions  and 
considering  the  other  two  QoS  metrics  of  interest  (packet  delay  and  loss  rate),  the 
following  are  the  minimum  set  of  data  associated  with  a  single  service  level  of  each 
interface  within  PIB; 

•  Current  bandwidth  utilization  (reported  by  routers  with  LSAs) 

•  Packet  queueing  delay  (reported  by  routers  with  LSAs) 


37 


•  Packet  loss  rate  (reported  by  routers  with  LSAs) 

•  Available  bandwidth  (calculated  in  PIB) 


•  Borrowing  capacity  (calculated  in  PIB) 


2,  Inter-service  Borrowing  at  the  Path  Level 


The  path  object  within  PIB  contains  only  those  elements  of  information  that  are 
relevant  to  the  admission  control  function.  For  the  path  selection  process,  it  suffices  to 
know  the  available  bandwidth,  with  and  without  inter-service  borrowing,  the  packet  delay 
from  origin  to  destination  and  the  packet  loss  rate  for  each  of  the  supported  service  levels. 
This  information  is  computed  from  available  data  stored  at  each  of  the  interfaces 
traversed  by  the  path.  Figure  4.5  illustrates  how  the  information  about  three  interfaces  is 
used  to  produce  the  available  bandwidth  for  a  path  traversing  those  interfaces. 


Path  QoS 

Inter-service  borrowing  capacity  at  the  path  ievei 


Interfaces  traversed  by  the  path 


Figure  4.5  Obtaining  path  QoS  information  from  the  interface  data 


In  the  example,  the  third  interface  shows  a  high  utilization  level  of  IntServ,  which 
is  already  borrowing  some  capacity  from  DiffServ  (dark  green).  Consequently,  this  path 
cannot  admit  any  more  IntServ  flows  unless  inter-service  borrowing  is  considered.  This  is 
shown  in  the  right  box,  which  contains  the  information  associated  with  the  path  as 
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calculated  from  the  interfaee  status.  Despite  not  being  shown  in  the  figure,  in  addition  to 
the  available  bandwidth,  the  path  objeet  eontains  also  the  end-to-end  paeket  delay  and 
paeket  loss  rate  information. 

3,  Propagating  Interface  State  Changes 

The  QoS  properties  of  a  path  may  change  due  to  the  admission  of  a  new  flow  or 
due  to  ehanges  of  observed  performance  in  one  or  more  of  the  interfaees  it  traverses. 
After  processing  a  LSA  of  type  UPDATE,  one  or  more  interfaces  in  one  more  service 
levels  may  have  their  observed  QoS  data  modified.  In  such  case,  the  set  of  paths  that 
traverse  the  modified  interfaees  must  also  be  evaluated  and  eventually  ehanged  to  refleet 
the  new  state  of  the  interfaees.  As  already  mentioned,  the  LSA  update  meehanism  allows 
the  PIB  to  follow  a  soft  state  approaeh  in  keeping  traek  of  admitted  flows.  Onee  flows  are 
admitted,  there  is  no  need  for  an  explieit  flow  termination  notifioation  and  it  suffiees  for 
PIB  to  maintain  per-interface  and  per-service  level  actual  aggregated  throughput.  While 
changes  in  service  level  bandwidth  utilization  may  have  no  impact  in  the  path 
information,  path  delay  and  loss  rate  changes  will  immediately  affeet  the  QoS  properties 
of  all  paths  traversing  the  interface. 

A  second  reason  for  an  interface  to  change  its  state  is  the  admission  of  a  new 
flow.  Figure  4.6  shows  an  example  of  two  paths  that  share  two  interfaces  in  routers  C  and 
D.  In  4.6(a),  it  can  be  observed  that  interfaces  1  and  3  are  the  bottleneck  for  paths  1  and  2 
respectively.  After  admission  of  a  new  flow  to  path  2,  all  interfaees  along  the  path  have 
their  available  bandwidth  reduced  by  the  amount  that  is  allocated  to  the  new  flow.  The 
following  step  is  to  propagate  ehanges  to  those  interfaees  to  all  other  paths  traversing 
them.  In  this  case,  it  is  observed  that  the  QoS  information  of  path  1  also  ehanges. 
Moreover,  the  bottleneek  router  for  path  1  ehanged  from  router  A  to  router  C  (from 
interfaee  1  to  interfaee  3). 
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Interface  and  Path  QoS 


(a)  -  Available  bandwidth  for  a  single  service  level,  two  paths  and  across  four  interfaces. 
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New  flow: 

B  ->  C  ->  D 
BW  request: 


12 


1" 

T  • 


I  l(^I4 

Path  1  QoS:  B+  =  □ 


"  I 


[£■ - ^  12^^14 

Path  2  QoS:  ” 


B 


□ 


(b)  -  Same  as  above,  after  admitting  a  new  flow  to  path  2. 


Figure  4.6  Propagation  of  interface  state  changes  after  admission  of  anew  flow 


The  example  of  figure  4.6  is  a  rather  simple  illustration  of  the  propagation  of 
interface  state  changes.  Utilization  changes  in  any  of  the  two  services  participating  in 
inter-service  borrowing  are  likely  to  propagate  not  only  across  the  QoS  of  paths  and 
interfaces  within  the  service  level  of  the  flow  request,  but  also  from  one  service  level  to 
the  other.  For  instance,  if  a  new  fntServ  flow  is  admitted  using  capacity  borrowed  from 
DiffServ,  changes  will  occur  in  the  available  bandwidth  of  both  services.  The  propagation 
of  such  changes  is  likely  to  become  process-intensive,  especially  in  large  SAAM  regions 
and  with  a  high  rate  of  flow  request  arrivals. 

4,  Performance  Issues 

The  complexity  and  the  associated  performance  concern  outlined  in  the  previous 
section,  was  always  present  during  the  redesign  of  PIB.  While  the  implementation  of 
inter-service  borrowing  represents  an  overhead  for  the  PIB  computation,  some  aspects  of 
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the  previous  PIB  design  have  been  modified,  which  are  thought  to  represent  an 
improvement  over  the  overall  PIB  efficiency.  For  instance,  when  processing  an  ISA,  the 
interface  data  only  changes  if  the  reported  data  vary  above  a  predefined  variation 
threshold.  In  any  case,  eventual  changes  will  only  be  propagated  after  all  service  state 
advertisement  (SSA)  information  blocks  are  processed  for  that  interface.  Initially,  the 
propagation  of  changes  occurred  after  processing  each  of  the  SSAs,  which  could  happen 
as  many  as  fifteen  times  per  each  ISA,  i.e.  the  number  of  service  levels  (live)  multiplied 
by  the  number  metrics  (three  -  utilization,  delay  and  data  loss  rate).  The  revised  PIB 
ensures  that  the  propagation  of  changes  happens  at  most  once  per  ISA  processed,  which 
represents  a  considerable  efficiency  improvement  over  the  previous  version. 

During  normal  network  operation,  PIB  will  be  processing  either  link  status 
messages  or  flow  requests.  The  arrival  rate  and  the  size  of  link  status  messages  are 
dictated  by  the  predefined  LSA  cycle  duration  and  the  number  of  router  and  interfaces 
supported  in  the  SAAM  region.  The  overhead  represented  by  the  arrival  of  flow  requests 
depends  upon  the  amount  of  network  resources,  e.g.  link  capacity,  and  other  external 
factors  like  average  flow  request  rate  and  flow  duration.  While  maintaining  a  short  LSA 
cycle  is  desirable  for  an  increased  accuracy  of  PIB  to  better  respond  to  new  flow 
demands,  it  also  represents  an  increase  in  processing  overhead.  Such  overhead  may  be 
excessive  in  presence  of  a  high  rate  of  flow  requests.  Long  LSA  cycles  however,  shall  be 
avoided  especially  is  the  network  load  changes  very  rapidly.  Because  of  time  limitations, 
choosing  optimum  values  for  those  parameters  is  outside  the  scope  of  this  study  and  is 
left  for  future  evaluation. 
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V.  SAAM  RESOURCE  MANAGEMENT  IMPLEMENTATION 


The  SAAM  prototype  has  been  developed  over  the  past  three  years  by  several 
students  contributing  to  the  SAAM  project  with  their  thesis  efforts.  As  part  of  this  thesis 
study,  the  new  resource  management  concept  as  described  in  the  previous  chapters  was 
fully  implemented  in  Java  and  integrated  into  the  Java  based  SAAM  prototype.  The 
implementation  and  integration  details  will  be  described  in  this  chapter.  Appendix  B 
contains  the  SAAM  source  code  that  was  either  created  or  modified  to  incorporate  the 
new  functionality.  With  the  embodiment  of  this  functionality,  the  SAAM  prototype  now 
has  a  greatly  improved  resource  management  capability. 

A.  OVERVIEW 

As  described  in  chapter  IV,  the  Path  Information  Based  (PIB)  is  the  core  element 
of  a  SAAM  server.  The  PIB  module  is  self-sufficient,  containing  both  network  data  and 
operations  that  are  responsible  for  the  SAAM  server  behavior.  SAAM  resource 
management  behavior  is  therefore  fully  provided  by  PIB.  Consequently,  the  PIB  was  the 
only  module  of  SAAM  that  was  modified  to  incorporate  the  new  resource  management 
mechanism  detailed  in  this  thesis.  The  PIB  is  implemented  by  the  BasePlB  java  class, 
which  in  turn  contains  several  inner  classes.  Table  5.1  contains  the  complete  listing  of  all 
those  classes  with  a  brief  description  about  the  purpose  of  each  one.  The  detailed 
description  of  each  of  the  BasePlB  data  members  is  fully  documented  in  [2].  Thus,  the 
focus  of  this  chapter  is  on  the  parts  of  PIB  that  were  created  or  modified  as  part  of  this 
thesis. 

The  implementation  of  inter-service  borrowing  required  an  extension  of  the 
existing  data  structures  that  supported  SAAM  and  a  redesign  of  the  PIB  behavior 
implementation.  Most  of  the  changes  directly  related  with  data  objects,  such  as  the 
Inter faceinfo  and  Path  objects,  were  accomplished  by  incorporating  additional  data 
members.  This  was  required  in  order  for  those  objects  to  keep  track  of  inter-service 
borrowing  capacity,  and  path  available  bandwidth.  The  redesign  of  the  PIB  behavior  was 
achieved  through  a  number  of  changes  to  existing  BasePlB  methods  and  additions  of 

several  new  methods.  In  addition,  the  path  selection  mechanism  was  tightly  integrated 
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into  the  existing  BasePlB  code.  A  new  class  named  RoutingAlgori  thm  was  created  to 
encapsulate  the  path  selection  behavior,  making  it  modular  and  ready  for  further 
development  with  regard  to  the  route  selection  process. 


Class  Name 


Description 


Main  PIB  class: 

saam . server . BasePIB 

PIB  inner  classes: 

Saam. server . BasePIB . Int&rfac&Info 
saam . server . BasePIB . ObsQoS 
saam. server . BasePIB . PathQoS 
saam. server . BasePIB . Path 
saam . server . BasePIB . aPIIndex 
saam . server . BasePIB . FlowQoS 


Main  class  that  implements  the 
PIB 


For  the  interface  object. 

For  the  interface  observed  QoS. 
For  the  path  QoS  information. 
For  the  path  objects. 

The  collection  of  paths  in  PIB. 
For  the  QoS  flow  properties. 


saam .  server .  BasePIB .  RoutingAlgori  thm  For  the  path  selection  scheme. 


Table  5.1 


List  of  PIB  classes 


The  following  sections  detail  all  the  changes  mentioned  above,  starting  with  all 
the  changes  made  to  the  inner  classes  of  BasePIB,  followed  by  modifications  applied  to 
the  BasePIB  methods,  and  finally,  the  implementation  of  the  new  RoutingAlgorithm 
class. 

B,  IMPLEMENTATION  DETAILS 

This  section  briefly  describes  BasePIB  and  each  of  its  inner  classes.  Each  of  the 
sub-sections  describes  a  single  class,  starting  with  a  general  description  of  the  class,  and 
followed  by  a  table  of  the  class’s  data  members  and  its  most  important  methods. 
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1. 


BasePIB  Support  Classes 


Several  support  classes  have  been  implemented  as  inner  classes  of  the  main 
BasePIB  class.  This  approach  can  be  justified  because  their  functions  are  only  relevant 
for  the  PIB  itself,  which  is  therefore  self-contained  within  the  BasePIB  class.  The 
following  sections  briefly  describe  each  of  those  classes. 

a.  Interfaceinfo  Class 

The  Interfaceinfo  class  defines  the  object  that  contains  all  key 
information  required  by  PIB  to  describe  a  single  SAAM  router  interface.  This  object 
contains  static  and  dynamic  information  about  the  interface.  The  static  information  is 
related  with  the  network  configuration  and  is  loaded  upon  initial  interface  advertisement 
(ISA-ADD).  The  dynamic  information  changes  very  often  upon  processing  LSA  or  flow 
request  messages,  interfaceinfo  data  members  are  listed  in  the  table  below. 


Name 

Type 

Description 

a  Obj Obj ectQoS 

ObsQoS  [ ] 

Array  of  ObsQoS  objects 

indexed  by  the  service 

level.  Maintain  status 

information  about  observed 

QoS. 

bSubnetMask 

byte 

The  number  of  bits  of  the 
subnet  mask. 

htPathIDs 

Hashtable 

Table  with  all  path  paths 
traversing  this  interface 
(outbound  direction). 

iNodelD 

Integer 

The  node  id  of  the  hosting 
router. 

iServicelevel Avail  able 

Bandwidth 

lnt[] 

Available  bandwidth  per 
service  level. 

IServlceLevelBor rowing 

Capa  cl ty 

lnt[] 

Borrowing  capacity  per 
service  level. 

I Total  Bandwidth 

Int 

Physical  interface 
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Name 

Type 

Description 

bandwidth. 

iUnallocatedBandwdith 

int 

Absolute  bandwidth  not 
allocated  to  any  service 
level. 

Table  5.2 

Data  members  of  inter  faceinfo  class 

The  table  below  lists  some  of  the  methods  provided  by  the 

Inter faceinfo  elass. 


Name 

Return 

Description 

getServicelevelAvailableBandwidth ( ) 

int  [] 

Retrieves  the 
available 
bandwidth  for  all 
of  the  service 
levels. 

getServicelevelBorrowingCapaci ty  (byte) 

int 

Retrieves  the 
borrowing  capacity 
for  the  given 
service  level. 

getUnallocatedBandwidth  () 

int 

Gets  the 

unallocated 

bandwidth. 

resetQoS  ( ) 

void 

Resets  the  QoS 
array. 

setServiceLevelBorrowingCapaci ty  (int) 

void 

Sets  the  borrowing 
capacity  for  a 
given  service  level. 

setServiceLevelUnallocatedBandwidth (int) 

void 

Sets  the 

unallocated 

bandwidth. 

Table  5.3  Methods  of  inter  faceinfo  elass 

b.  ObsQoS  Class 

The  ObsQoS  elass  defines  an  objeet  that  is  associated  with  a  single  service 
level  at  each  interface.  This  object  contains  observed  QoS  information  for  that  service 
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level  as  reported  by  routers  through  LSA  messages.  The  table  below  lists  ObsQoS  data 
members. 


Name 

Type 

Description 

iDelay 

short 

The  data  delay  observed  at  this  interface  for  a  given 
service  level. 

iLossRate 

short 

The  data  loss  rate  at  this  interface  for  a  given  service 
level. 

iUtilization 

short 

The  bandwidth  utilization  of  a  given  service  level,  as 
a  scaled  percentage  of  the  total  interface  bandwidth. 

Table  5.4 

Data  members  of  ObsQoS  class 

c. 

PathQoS  Class 

The  PathQoS  elass  defines  an  objeet  that  is  assoeiated  with  a  single  path. 
This  objeet  eontains  relevant  end-to-end  QoS  and  resouree  availability  information  for  a 
particular  service  level.  The  table  below  lists  PathQoS  data  members. 


Name 

Type 

Description 

PathAvBW 

int 

The  path  available  bandwidth  for  a  given  service 
level. 

pathAvBWwBor rowing 

int 

The  path  available  bandwidth  for  a  single  service 
level,  possible  incremented  by  borrowed 
bandwidth. 

PathDelay 

short 

The  total  path  delay  for  a  given  service  level,  i.e. 
current  delay  experienced  by  traffic  along  the  path. 

pathLossRate 

short 

The  current  total  data  loss  rate  for  a  given  service 
level,  experienced  by  traffic  along  the  path. 

Table  5.5 

Data  members  of  PathQoS  class 

Method  Name 

Return  Type  Description 

getAvailableBandwidth  0  int  Retrieves  path  available 

bandwidth  for  the  service  level. 
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Method  Name 

Return  Type 

Description 

getAva liable Band! wdthinclu 

dlngBorrowlng ( ) 

Int 

Retrieves  path  available 
bandwidth  for  the  service  level 
and  considering  borrowing. 

set Aval lableBandwldth 

(Int) 

void 

Sets  a  new  value  for  available 
bandwidth. 

setAvallableBandwldthlnclu 

dlngBorrowlng ( Int) 

void 

Sets  a  new  value  for  available 
bandwidth  including  borrowing 

Table  5.6 

Methods  of  Path  QoS'  class 

d.  Path  Class 

The  Path  class  defines  an  object  that 

table  below  lists  data  members  of  the  Path  class. 

is  associated  with  a  single  path.  The 

Name  Type 

Description 

ahtFlows 

Hashtable  [ ] 

An  array  of  look-up  tables  for  flows 
assigned  to  a  path.  Array  is  index  by  service 
level. 

bCreated 

boolean 

Signals  whether  routing  tables  have  been 
update  at  the  routers  traversed  by  this  path. 

iNewFlowID 

Int 

For  the  assignment  of  flow  IDs. 

iPathlD 

Integer 

The  ID  of  this  path. 

ml rrorPath 

Path 

The  mirror  path,  i.e.  the  path  that  traversed 
the  same  interfaces  but  in  opposite 
direction. 

objaPI Index 

aPIIndex 

A  cross-reference  to  the  array  of  path 
objects. 

obj  PathQoS 

PathQoS  [ ] 

The  array  of  PathQoS  objects  that  contain 
the  QoS  information  of  this  path,  per 
service  level. 

Vinter fa ceSequence 

Vector 

The  Vector  object  containing  the 
sequence  of  interfaces  traversed  by  this  path 

(outbound),  listed  from  destination  to 
souree  node. 
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Name 

Type 

Description 

vNodeSequence 

short 

A  Vector  object  containing  the  sequence 
of  nodes  (routers)  the  path  traverses,  listed 
from  destination  to  source. 

Table  5.7  Data  members  of  Pa  th  class 

e.  aPIIndex  Class 

This  class  is  a  data  member  of  the  Path  class.  It  is  used  to  create  an 
index  object  for  quick  access  to  the  path  information  array  a  Pi.  The  index  fields  are 
source  node,  destination  node  and  hop  count.  Given  a  path  object,  this  object  can  be  used 
to  obtain  the  aPl  element  (a  vector  of  paths)  that  contains  the  path. 

Name  Type  Description 

iDestination  Integer  The  last  node  ID  of  the  path. 

iHopCount  int  The  hop  count  of  the  path. 

iSource  Integer  The  first  node  ID  of  the  path. 

Table  5.8  Data  members  of  aPPindex  class 

f.  FlowQoS  Class 

The  FlowQoS  class  defines  an  object  that  characterizes  the  QoS  of  a 
single  flow  request.  The  table  below  lists  FlowQoS  data  members. 


Name 

Type 

Description 

requestedBandwidth 

int 

The  bandwidth  capacity  being  requested. 

requestedDelay 

short 

The  requested  delay  bound. 

requestedlossRate 

short 

The  requested  loss  rate  bound. 

timestamp 

long 

When  the  flow  request  is  made. 

Table  5.9  Data  members  of  FlowQoS  class 
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g.  RoutingAlgorithm  Class 

The  RoutingAlgorithm  class  implements  a  stateless  object.  Routing 
algorithm  objects  behave  like  function  objects,  providing  only  the  path  selection 
functionality  to  PIB,  based  on  the  selected  routing  algorithm.  The  current  version  of  this 
class  only  implements  the  First-Shortest  Path  (FSP)  algorithm  but  the  class  can  be  easily 
extended  to  provide  different  path  selection  schemes. 


Method  Name 

Return  Type 

Description 

findPath  (src ,  dest, 

algori  thm) 

Path 

Selects  a  path  from  PIB,  between  src 
and  dest,  using  the  selected  algorithm. 

findPath  (src ,  dest , 

qos , si , borrowing , 

algori  thm) 

Path 

Selects  a  path  from  PIB,  between  src 
and  dest,  using  the  selected  algorithm 
and  meeting  the  required  QoS  demand 
with  borrowing  as  option. 

Table  5.10 

Methods  of  RoutingAlgori  thm  class 

2.  BasePIB  Class 

The  BasePIB  class  is  the  main  PIB  class.  Within  the  SAAM  server,  the  PIB 
object  is  an  instance  of  the  BasePIB  class,  extending  the  underlying  organization  as 
inherited  from  the  PathinformationBase  abstract  class.  The  BasePIB  comprises 
several  data  members  organized  to  create  a  complex  data  structure,  which  ultimately 
represents  an  image  of  the  SAAM  region,  containing  both  static  and  dynamic  information 
about  the  supported  SAAM  network.  As  stated  before  the  full  detail  about  the  PIB 
implementation  can  be  found  in  [2].  For  the  purpose  of  this  thesis,  it  is  only  relevant  to 
cover  the  parts  of  PIB  that  have  been  modified  or  created  for  this  thesis  or  are  dimmed  to 
be  important  for  describing  the  implementation  of  the  new  resource  management  and 
inter-service  borrowing  mechanisms.  The  table  below  lists  the  most  relevant  BasePIB 


data  members. 

Name 

Type 

Description 

a f BASE  ALLOCATION 

float  [ ] 

The  fraction  of  the  total 
interface  bandwidth,  initially 
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Name 

Type 

Description 

allocated  to  each  service 
level. 

a f LOAD  FACTOR 

float[] 

The  maximum  load  capacity 
within  each  of  the  service 
levels. 

aPI 

Hashtable  [][][] 

A  tri-dimensional  array  of 
hash  tables  containing  all 
paths  between  any  nodes  for  a 
given  hop  counts. 

BORROWING  PROB  OFFSET 

float 

The  borrowing  limit  as  an 
offset  factor,  depending  upon 
the  selected  probability  (95% 
equates  to  0.164). 

BORROWING  THRESHOLD 

float 

The  borrowing  threshold. 

DISPLAY  FULL  DETAIL 

boolean 

Whether  the  PIB  gui  will 
display  full  detail. 

htinter faces 

Hashtable 

Collection  of 

Inter faceinfo  objects, 
keyed  by  Interface  address 
string. 

ht Paths 

Hashtable 

Collection  of  all  Path 
objects,  keyed  by  path  id 
integer  object. 

routingAlgori thm 

RoutingAlgori thm 

The  instance  of  the  Routing 
Algorithm. 

Table  5.11 

Data  members  of  BasePlB  class 

The  table  below  lists  some  of  the  relevant  BasePlB  methods 

Method  Name 

Return  Type 

Description 

admlsslonControl  BE 

Int 

Performs  the  admission 

(FlowRequest) 

sequence  for  BE. 

admlsslonControl  DS 

Int 

Performs  the  admission 

FlowRequest ( ) 

sequence  for  DiffServ. 

admlsslonControl  IS 

Int 

Performs  the  admission 
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Method  Name 

Return  Type 

Description 

(FlowRequest) 

sequence  for  IntServ. 

BorrowingCapaci  ty 

(bw,  utiliz ,  si) 

Int 

Calculates  the  borrowing 
capacity  given  the  service 
level  bandwidth,  current 
utilization  and  the  service 
level. 

FindPathDelayAndLossRate 

(Path) 

short [ ] [ ] 

Discovers  path  delay  and  loss 
rate. 

IsRouteFeasable (src, dest) 

boolean 

Checks  if  a  path  exists 
between  src  and  dest. 

pa thBandwi dth (Path) 

lnt[]  [] 

Discovers  path  available 
bandwidth,  with  and  without 
borrowing,  for  all  service 
levels. 

pathBandwidth ( Path ,  si) 

lnt[] 

Discovers  path  available 
bandwidth,  with  and  without 
borrowing,  for  the  given 
service  level. 

Process FlowRequest 

Int 

Processes  a  new  flow  request. 

(FlowRequest) 

ProcessLSA 

void 

Processes  incoming  LSA 

(L Inks tatus Advertisement) 

messages. 

RefreshInterfaceBW 

( Inter faceinfo ,  bandwidth 

reduction ,  svc  level) 

void 

Refreshes  the  interface 
available  bandwidth  following 
the  admission  of  a  new  flow. 

RefreshInterfaceQoS 

(Interface  Info) 

void 

Refreshes  the  interface 
available  bandwidth  after 
processing  an  LSA  that 
incurred  changes. 

refreshPathQoS (Path) 

void 

Refreshes  path  QoS. 

RefreshPathQoS 

(Path,  qos  variations) 

void 

Refreshes  path  QoS  based  on 
the  provided  QoS  changes. 

resetQoS  ( ) 

void 

Resets  PIB  QoS  information  . 
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Method  Name 

Return  Type 

Description 

setInterserviceBorrowing  (Bool 

ean) 

void 

Sets  the  state  of  inter-service 
borrowing. 

setupPath ( Path ,  int) 

void 

Sets  up  a  path,  by  sending  the 
routing  table  update  messages 
to  routers. 

update Aval lableBandwidth  (Path 

,  bandwidth,  svc  level) 

void 

Updates  the  available 
bandwidth  of  a  path  after  a 
flow  admission. 

updateinterface ( Inter faceSA) 

void 

Processes  ISAs  for  updating 
an  interface  with  observed 

QoS 

Table  5.12  Methods  of  SasePJS  class 


C.  MAJOR  PIB  MODIFICATIONS 

The  main  functions  of  PIB  were  outlined  in  chapter  IV.  The  previous  section 
briefly  listed  main  components  of  the  PIB  implementation.  In  this  section,  the  PIB 
operation  is  described  in  terms  of  the  two  main  PIB  functions,  i.e.,  processing  LSA  and 
Flow  request  messages. 

1.  LSA  Message  Processing 

Whenever  an  LSA  is  to  be  processed  by  PIB,  the  parent  object  of  PIB  (Server) 
invokes  processLSA  ()  .  This  method  first  checks  if  it  the  LSA  is  from  a  new  node.  In 
that  case,  the  new  node  is  created  and  added  to  PIB.  In  either  case,  the  LSA  is  stripped 
into  one  or  more  ISAs.  Finally,  depending  upon  the  type  of  ISA,  updatelnterfaceQ, 
removelnterfaceQ  or  addlnterfaceQ  methods  is  invoked  once  per  ISA. 

a.  addlnterfaceQ 

When  an  interface  is  first  advertised  by  a  router,  the  respective 
Inter faceinfo  object  is  created  and  stored  in  PIB.  The  inter faceinfo  constructor 
initializes  interface  data  and  then  calls  the  refreshinterfaceQoSQ  method. 
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b.  updatelnterfaceQ 

This  method  is  invoked  from  processLSA(),  to  process  a  single  ISA- 
UPDATE.  An  ISA  may  in  turn  contain  one  or  more  SSAs  for  that  interface.  Each  metric 
value  of  each  SSA  is  extracted  and  the  respective  variable  in  the  interface  QoS  array 
updated  if  the  changes  is  above  a  predefined  threshold.  The  two  arrays  deltaLossRate 
and  deltaDelay  keep  track  of  all  changes  introduced  while  processing  all  SSAs  in  this 
ISA.  After  all  SSAs  are  processed,  then  if  the  observed  QoS  of  this  interface  effectively 
has  changed,  refreshlnterfaceQoSQ  is  called.  Einally,  when  the  QoS  properties  of 
the  interface  has  changed,  for  every  path  traversing  this  interface,  the 
refreshPathQoSQ  is  called,  providing  as  arguments  the  deltaDelay  and 
deltaLossRate  arrays. 

c.  refreshlnterfaceQoSQ 

This  method  may  be  invoked  by  the  interfaceinfo  constructor  during 
initial  interface  object  instantiation  or  from  the  updatelnterfaceQ  method,  after 
processing  all  SSAs  of  a  single  ISA.  In  either  case,  it  first  calculates  the  unallocated 
bandwidth  from  the  current  service  level  utilizations  and  total  interface  bandwidth.  Eor 
each  service  level,  it  calculates  the  available  bandwidth,  service  level  base  allocation  and 
borrowing  capacity,  all  as  a  function  of  current  utilization  and  base  allocation.  Eor  this 
last  purpose,  the  method  borrowingCapacityQ  is  invoked. 

d.  refreshPathQoSQ 

The  purpose  of  this  method  is  to  refresh  the  path  QoS  after  changing  the 
QoS  properties  of  one  outbound  interface  along  that  path.  When  invoked  from  the 
updatelnterfaceQ  method,  the  provided  deltaDelay  and  deltaLossRate 
information  allows  rapidly  setting  of  the  new  path  delay  and  loss  rate  values.  However, 
for  determining  the  path  available  bandwidth,  it  is  still  required  to  visit  all  interfaces 
traversed  by  the  path.  This  is  achieved  by  invoking  the  method  pathBandwidthQ.  An 
overloaded  version  of  this  method  is  invoked  by  any  of  the  four  path  constructors,  for  the 
initialization  of  the  path  QoS.  In  this  case,  the  path  delay  and  data  loss  rate  is  obtained  by 
invoking  the  method  findPathDelayAndLossRateQ. 
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e. 


borrowingCapacityO 


Given  the  current  utilization,  the  base  allocation  and  with  the  predefined 
offset  factor  and  borrowing  threshold,  this  method  calculates  the  borrowing  capacity  of  a 
service  level. 

f.  pathBandmdthQ 

The  method  traverses  all  interfaces  of  a  given  path  to  discover  the 
minimum  available  bandwidth  per  service  level.  For  each  service  level,  two  values  are 
obtained;  available  bandwidth  with  and  without  inter-service  borrowing. 

g,  JindPathDelayAndLossRateQ 

This  method  traverses  all  interfaces  of  a  given  path.  For  each  of  the 
service  levels,  it  calculates  the  path  delay  and  data  loss  rate  across  the  entire  path. 

2,  Flow  Request  Message  Processing 

A  Flow  Request  message  is  passed  to  PIB  by  the  Server  object  invoking  the 
method  processFlowRequestQ.  This  is  the  starting  point  for  the  admission  control 
sequence,  which  follows  different  paths  depending  upon  the  service  level  of  the  flow 
request.  The  following  is  the  description  of  all  the  methods  that  are  directly  involved  in 
this  admission  control  sequence. 

a.  processFlowRequestQ 

This  method  simply  receives  the  Flow  Request  and  then,  depending  upon 
the  service  level  of  the  request,  invokes  the  respective  admission  control  method. 

b.  admissionControlBEQ 

The  admission  sequence  for  a  BE  is  the  simplest.  The  information  about 
source  and  destination  routers  is  first  extracted  from  the  message.  Then  the  routing 
algorithm  object  is  called  to  select  the  path  and  finally  the  flow  response  is  generated 
with  the  flow  label  information  and  sent  back  to  the  source  router 

c.  admissionControlISQ 

The  admission  sequence  for  IntServ  starts  by  first  extracting  the  request 

information  including  the  QoS  parameters.  The  method  isRouteFeasableQ  is  called  to 
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verify  if  a  valid  path  exists,  eonnecting  souree  and  destination  routers.  If  that  path  exists 
then  the  routing  algorithm  objeet  is  invoked  to  seleet  the  best  path  aeeording  to  the 
requested  QoS  parameters  and  the  seleeted  routing  algorithm.  Then  if  it  sueeeeds, 
network  resourees  will  be  alloeated  by  ealling  the  method 
updateAvailableBandwidhtQ.  Finally,  the  new  flow  is  added  to  the  seleeted  path,  a 
Flow  Response  message  is  generated  and  sent  to  the  elient  applieation  and,  if  neeessary, 
the  routing  table  updates  for  the  path  are  sent  to  the  routers  aeross  the  path. 

d.  admissionControlDSO 

The  admission  sequence  for  a  DiffServ  flow  request  differs  from  the 
IntServ  sequence  only  in  the  fact  that  requesting  users  need  to  be  identified  and  their  QoS 
parameters  are  extracted  from  the  pre-established  service  level  agreement  with  those 
users. 

e.  isRouteFeasableQ 

This  method  simply  searches  the  array  of  path  information  (a Pi)  for 
ensuring  that  there  exists  at  least  one  physical  path  between  source  and  destination. 

f.  updateAvailableBandmdthQ 

This  method  performs  the  resource  reservation  step  in  the  admission 
sequence.  The  arguments  are  the  path,  the  granted  bandwidth  and  the  target  service  level. 
Adding  a  flow  to  a  path  reduces  the  available  bandwidth  of  all  interfaces  traversed  by  that 
path.  This  method  ensures  that  all  of  those  interfaces  are  visited  and  for  each  one,  the 
method  refreshlnterfaceBwQ  called  to  perform  the  respective  interface  QoS  update. 

g.  refreshlnterfaceBWQ 

This  method  is  invoked  once  for  every  interface  traversed  by  a  given  path, 
after  admission  of  new  Difffierv  or  IntServ  flow.  The  available  bandwidth  for  the  target 
service  level  is  reduced  by  the  same  amount  granted  to  the  new  flow.  However,  the 
refresh  algorithm  needs  to  determine  in  which  stage  the  bandwidth  allocation  is  at,  i.e. 
direct,  dynamic  or  inter-service  borrowing.  This  is  relevant  to  calculate  the  new 
unallocated  bandwidth  and  borrowing  capacity.  Eventual  changes  in  the  unallocated 
bandwidth  are  also  reflected  in  the  available  bandwidth  for  the  other  service  level.  For 
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instance,  if  the  admission  of  a  new  IntServ  flow  decreases  the  unallocated  bandwidth, 
final  available  bandwidth  for  both  IntServ  and  DiffServ  need  to  be  updated.  Finally, 
ehanges  in  the  available  bandwidth  of  a  single  interfaee  propagate  to  paths  traversing  that 
interfaee.  Consequently,  all  paths  traversing  affeeted  interfaees  need  to  be  evaluated  for 
eventual  path  QoS  ehanges.  For  that  purpose,  the  method  pathBandwidthQ  is  ealled. 
For  efficieney  reasons,  this  last  path  update  phase  is  not  done  immediately  after  a  single 
interfaee  change  is  introdueed.  Instead,  as  interfaces  are  updated,  the  refresh  algorithm 
keeps  traek  of  the  affeeted  paths.  At  last,  when  all  affeeted  interfaees  have  been  updated, 
eaeh  of  those  paths  is  evaluated.  The  efficieney  gain  is  more  evident  when  more  than  one 
interface  is  traversed  by  the  same  path. 


D,  CONTROLLING  PIB  BEHAVIOR 

It  is  desirable  to  control  the  behavior  of  PIB  as  it  interacts  with  the  other  network 
players.  Some  of  that  control  may  be  static  and  is  therefore  hard-coded  and  other  can  be 
used  by  other  SAAM  modules,  like  a  future  network  management  console.  The  following 
table  summarizes  those  parameters  of  PIB  that  may  change  its  configuration  and  the  way 
it  operates. 


Name 


Description 


final  boolean 
TESTING_MODE 

final  boolean 
DISPLAY_EULL_DETAIL 

final  boolean 

INTERSERVICE  BORROWING  DEEAULT 


Defaults  to  false.  When  set  to  true,  a 
PIB  Tester  elass  is  instantiated.  The  PIB 
tester  has  its  own  gui  and  can  be  used  to 
inject  flow  requests  and  LSA  messages 
in  PIB  as  well  as  other  interactions  with 
PIB.  Chapter  VI  eovers  this  tester  in 
detail. 

Defaults  to  false.  When  set  to  true,  the 
PIB  gui  in  the  SAAM  demo  station 
displays  more  detailed  information 
about  PIB  operation.  This  is  ideally 
suited  for  PIB  diagnosis  or  to  monitor 
the  execution  flow  within  PIB. 

The  default  state  for  inter-serviee 
borrowing.  It  defaults  to  true,  which 

means  it  is  enabled 
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Name 


Description 
means  it  is  enabled. 


final  float  BORROWING_THRESHOLD 

final  float 

B  ORROWING_  PR  OBAB  ILITY_  OFFSE  T 

final  float  afBASE_ALLOCATION[] 

final  float  afLOAD_FACTOR[] 
setinterserl veBorrowlng ( ) 


The  borrowing  threshold  is  the  level 
above  which  base  allocation  bandwidth 
can  be  made  available  for  borrowing. 
The  default  value  is  0.6,  i.e.  60%  of  the 
base  allocation. 

This  offset  factor  is  derived  from  the 
selected  probability  for  inter-service 
borrowing,  as  derived  from  equation 
3.11  in  chapter  III.  Default  value  is 
0.164  as  given  by  the  probability  of 
95%. 

This  array  defines  the  base  bandwidth 
allocation  for  all  service  levels 
supported.  The  share  of  each  service 
level  should  be  so  that  the  summation  is 
less  than  or  equal  to  the  unit  value. 

This  array  defines  the  maximum  load  to 
be  supported  for  each  of  service  levels. 

Enables  to  dynamically  enable  or 
disable  inter-service  borrowing. _ 


Table  5.13  PIB  configuration  elements 
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VI.  PIB  TEST  AND  PERFORMANCE  ANALYSIS 


The  performance  evaluation  of  the  proposed  resource  management  technique  is  a 
key  aspect  for  this  research  study.  Some  of  the  concepts  developed  during  the  previous 
chapters  have  a  statistical  base.  A  few  assumptions  require  validation.  This  chapter 
describes  the  approach  used  for  testing  and  evaluating  the  new  PIB,  the  design  and 
implementation  details  of  the  PIB  tester  module,  the  specific  experiments  carried  out,  and 
finally,  the  analysis  of  the  data  collected. 

A,  APPROACH 

After  completing  the  implementation,  the  code  was  checked  for  correctness. 
Every  single  section  was  checked  for  correct  logic  implementation  in  accordance  with  the 
resource  management  algorithm.  The  execution  flow  and  input/output  of  the  different 
methods  was  ensured  to  be  as  expected.  Once  the  initial  check  was  complete,  a  functional 
check  of  the  whole  PIB  was  conducted.  The  two  main  functions  being  checked  were  the 
processing  of  ESA  messages  and  Elow  Request  messages.  ESA  generation  is  not  yet 
completely  functional.  Current  SAAM  prototype  produces  a  limited  number  of  ESAs 
during  the  initial  configuration  cycles.  Elow  generator  agents  may  be  used  to  generate 
flow  request  messages.  While  this  approach  was  acceptable  to  check  the  general 
correctness  of  the  implementation,  it  was  far  less  than  what  is  required  to  test  the  whole 
resource  management  algorithm  under  normal  network  operation. 

Accurate  ESA  reporting  is  essential  for  PIB  to  maintain  coherent  status 
information  about  the  network.  However,  the  link  state  monitor  in  the  router  prototype  is 
not  fully  implemented,  which  causes  incorrect  link  status  information  to  arrive  to  PIB. 
Another  apparent  limitation  of  the  current  SAAM  prototype  has  to  do  with  the  process  of 
generating  flow  requests  and  network  traffic.  While  the  current  system  for  launching  flow 
generator  agents  is  adequate  for  a  small  number  of  flows,  it  does  not  scale  well  to  several 
hundreds  of  flows.  Without  generation  of  precise  ESA  messages,  it  is  not  possible  to  test 
complete  PIB  operation.  Moreover,  testing  the  new  resource  management  capability  of 
PIB  requires  complete  control  over  a  large  number  of  flows. 


59 


B,  TEST  DESIGN 

The  performance  study  carried  out  in  this  thesis  followed  a  different  approach. 
The  SAAM  auto-configuration  process  is  run  for  only  one  cycle,  at  the  end  of  which  the 
target  PIB  is  created  based  on  the  LSA  messages  from  LSA  monitors  of  all  routers. 
Afterwards,  a  computer  simulation  program  called  PibTester  is  used  to  produce  all  flow 
request  and  LSA  messages,  circumventing  the  shortcomings  of  current  traffic  generator 
agents  and  LSA  monitors.  The  theoretical  foundations  for  this  evaluation  can  be  found  in 
[11].  The  following  sub-sections  describe  the  different  steps  undertaken. 

1,  System  Definition  and  Testing  Goals 

As  mentioned  before,  the  new  resource  management  scheme  was  fully 
implemented  within  the  PIB.  The  key  component  of  SAAM  that  is  under  study  is 
therefore  the  PIB  of  a  SAAM  server.  For  that  purpose,  the  test  is  confined  to  interactions 
with  the  BasePlB  class,  including  all  of  its  internal  support  classes.  However,  the  full 
SAAM  prototype  should  be  up  and  running  as  normal,  reflecting  the  normal  operating 
environment.  The  goals  of  this  test  will  be  to  (1)  evaluate  the  correctness  of  PIB  resource 
management  operation  under  normal  load  conditions;  (2)  evaluate  the  impact  of  inter¬ 
service  borrowing  in  terms  of  efficient  management  of  network  resources.  In  order  to 
attain  these  goals,  the  network  must  work  under  extreme  load  conditions  for  some 
service,  i.e.,  at  the  point  where  inter-service  borrowing  is  required.  Additionally,  it  should 
suffice  to  consider  the  two  service  levels  with  dynamic  bandwidth  allocation,  i.e.,  IntServ 
and  DiffServ. 

2,  Defining  Services 

The  system  service  is  identified  as  network  resources  allocated  to  network  users. 
In  this  study,  the  focus  is  on  the  amount  of  link  capacity  the  network  resource 
management  system  is  able  to  allocate  to  users. 

3,  Selecting  Metrics 

In  the  beginning,  the  test  is  limited  to  validating  correct  operation  of  PIB.  As 
Flow  Request  messages  arrive,  the  PIB  should  be  able  to  complete  the  admission 
procedure  and  allocate  resources  accordingly.  The  accurate  LSA  generation  based  on 
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traffic  of  active  flows  is  a  major  requirement  for  the  testing.  After  proeessing  these  LSA 
messages,  the  PIB  should  aeeurately  refresh  its  state  to  refleet  new  LSA  information.  The 
ability  to  monitor  the  PIB  state  in  general  and  the  interfaee  and  path  status  information  in 
partieular  plays  a  major  role  in  testing  the  PIB. 

In  the  seeond  phase  of  testing,  we  are  interested  in  the  number  of  flows  arriving  at 
PIB  versus  the  number  of  flows  that  are  rejeeted,  in  different  serviee  levels.  This 
information  should  be  eross-refereneed  with  the  number  of  aetive  flows,  from  whieh  it  is 
then  possible  to  ealeulate  the  expeeted  link  load  for  eaeh  of  the  serviee  levels. 

4,  Listing  Parameters 

Several  parameters  have  been  identified  to  affect  the  resource  management 
performanee.  These  parameters  can  be  divided  into  system  and  workload  parameters  as 
follows; 

a.  Systems  Parameters 

•  LSA  generation  period; 

•  Borrowing  threshold; 

•  Borrowing  probability; 

•  Service  level  Base  Allocation; 

b.  Workload  Parameters 

•  Number  of  active  flows; 

•  Flow  duration  /  requested  bandwidth  (distribution); 

•  Inter-arrival  time  of  flow  requests; 

5,  Factors  Under  Test 

The  key  factor  chosen  for  the  purpose  of  this  test  is  inter-serviee  borrowing.  The 
focus  will  be  on  the  response  of  the  PIB  resource  management  with  inter-service 
borrowing  enabled  as  opposed  to  inter-serviee  borrowing  disabled.  Additionally,  different 
borrowing  threshold  values  will  be  used  to  evaluate  the  impact  on  flow  rejection. 
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6. 


Evaluation  Technique 


Since  the  PIB  is  fully  prototyped,  it  is  possible  to  perform  a  complete  functional 
test  of  PIB.  The  measurement  technique  will  be  used  to  collect  performance  data  from 
PIB.  Simulation  will  be  used  to  generate  flow  requests  and  to  LSA  messages. 

7,  Workload 

The  workload  for  this  test  consists  of  a  number  of  flow  requests  continuously 
arriving  at  PIB,  following  a  predefined  network  load  profile.  At  the  same  time,  LSA 
generation  ensures  accurate  link  state  information  is  reported  to  PIB.  These  LSA 
messages  should  emulate  the  tasks  of  routers  advertising  link  utilization  based  on 
network  traffic  generated  by  active  flows. 

8,  Designing  the  Experiments 

Two  different  topologies  will  be  used  for  testing  as  described  below. 
a.  Network  A 

This  is  the  simplest  topology  and  as  depicted  in  figure  6.1,  the  network 
will  be  made  of  three  nodes;  one  SAAM  server  and  two  SAAM  routers.  The  goal  is  to 
test  PIB  resource  management  across  a  single  link  between  two  routers.  For  that  purpose, 
the  simulation  will  generate  flow  requests  for  traffic  going  from  A  to  B.  The  objective  is 
to  obtain  utilization  and  flow  rejection  data  about  interface  2..1  at  router  A,  as  the 
network  load  increases. 


Network  A 


SCCkbps”” 

Server 

Figure  6.1 


1..2 


300kbps 


2..1 


2..2 


1000kbps 


500kbps 


Router  A 


Test  Traffic 


>' 


Router  B 


Test  topology  A  -  1  server,  2  routers 


b.  Network  B 

The  focus  of  network  A  is  to  analyze  the  resource  management  working  at 
the  link  level  and  over  a  single  network  link.  With  network  B  however,  we  are  interested 

to  observe  the  behavior  of  PIB  when  alternate  paths  are  available  and  when  admission  of 
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a  single  flow  indirectly  affect  other  paths.  The  network  is  required  to  be  loaded  with 
traffic  such  that,  for  any  source-destination  pair  different  paths  may  be  selected  at 
different  times.  Flows  are  generated  from  a  random  source  to  a  random  destination 
among  the  three  routers  A,  B  and  C.  The  selected  topology  for  network  B  is  depicted  in 
figure  6.2. 


Network  B 


Router 


Figure  6.2  Test  topology  B  -  1  server,  3  routers 


C.  PIB  TESTER 

1,  Tester  Requirements 

As  mentioned  in  the  beginning  of  this  chapter,  there  were  two  major  factors 
driving  the  need  for  developing  a  specific  PIB  tester:  accurate  LSA  generation  and 
effective  control  over  a  large  number  of  flow  requests.  The  following  basic  requirements 
were  identified  for  that  tester: 

•  Generate  and  send  to  PIB  a  stream  of  flow  request  messages,  in  accordance 
with  a  predefined  link  load  profile. 

•  Generate  and  send  periodic  LSA  messages  to  PIB.  The  LSA  information 
should  emulate  the  link  status  according  to  the  number  and  characteristics  of 
active  flows. 

•  Store  status  data  every  time  the  system  (the  PIB  and  the  tester)  changes  state. 

•  All  testing  should  be  external  to  PIB. 
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2. 


Tester  Module 


The  class  PibTester  was  created  for  the  only  purpose  of  testing  PIB. 
PibTester  is  instantiated  by  BasePlB  whenever  the  TESTING_MODE  flag  in  the 
beginning  of  BasePlB  code  is  set  to  true.  The  tester  runs  in  a  separated  thread  and  has  its 
own  GUI  interface.  Since  the  tester  is  a  BasePlB  object,  it  has  direct  access  to  BasePlB 
methods.  However,  only  two  methods  of  BasePlB  are  used  by  the  tester:  processLSA  () 
and  processFlowRequests  () .  These  are  exactly  the  same  methods  used  by  the  parent 
class  of  BasePlB  (Server  class)  to  process  incoming  ESA  and  Elow  request  messages. 
Synchronization  is  not  required  as  long  as  other  SAAM  players  do  not  send  ESA  or  Elow 
request  messages  to  the  server.  The  tester  automatically  waits  for  initial  cycle  to  complete 
and  no  more  ESA  messages  will  arrive  to  PIB  from  sources  other  than  the  tester.  Plow 
generator  agents  should  not  be  deployed  to  SAAM  routers  therefore  avoiding  flow 
requests  to  arrive  to  PIB.  The  tester  as  described  above  will  be  the  sole  player  interacting 
with  PIB. 

The  core  element  of  the  PibTester  is  a  priority  queue,  which  may  contain  three 
types  of  event  objects:  flow  request,  flow  termination  and  ESA.  Before  a  simulation  run 
starts,  the  priority  queue  is  loaded  with  flow  request  and  ESA  events  for  the  duration  of 
the  trial.  The  number  of  ESA  events  is  determined  by  simulation  length  and  the  ESA 
cycle  time.  The  number  of  flow  requests  for  each  of  the  two  services  being  considered 
(IntServ  and  DifiServ)  is  determined  by  the  respective  flow  arrival  distribution.  When  a 
simulation  run  starts,  the  simulation  time  is  used  to  determined  when  events  are 
dequeued.  Every  time  a  flow  request  event  is  dequeued,  a  Plow  Request  message  is  sent 
to  PIB.  As  flows  are  accepted,  the  tester  updates  its  own  database  of  interfaces  to  keep 
track  of  active  flows  and  interface  utilization.  Additionally,  a  flow  termination  event  is 
enqueued,  with  an  event  time  that  corresponds  to  end  of  the  newly  admitted  flow.  When 
flow  termination  events  are  processed,  the  database  of  interfaces  in  the  tester  is  updated 
to  reflect  the  new  network  resources  becoming  available.  An  ESA  event  triggers  one  ESA 
message  for  every  router  represented  in  the  database  of  interfaces  within  the  tester.  The 
current  interface  utilization  is  used  to  report  to  PIB  the  emulated  interface  status.  The 
ESA  will  therefore  reflect  the  number  of  virtual  active  flows  using  the  network. 
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During  a  normal  simulation  run,  the  tester  GUI  displays  simulation  progress, 
status  information  as  obtained  from  the  Path  Information  Base,  and  limited  statistical 
data.  Additionally,  at  every  single  simulation  event,  a  line  of  status  data  is  written  to  an 
ASCII  file  for  posterior  analysis.  Figure  6.3  is  a  screen  shot  of  the  tester  interface,  during 
a  simulation  run  of  network  A.  The  central  area  of  the  display  shows  individual  interface 
data  stored  in  the  Path  Information  Base.  For  example,  the  encircled  area  contains 
information  about  interface  2..1.  Appendix  4  contains  a  detailed  description  of  the  tester 
functionality  and  appendix  5  contains  all  of  its  source  code. 


Figure  6.3  A  snap  shot  of  the  PIB  tester,  during  a  simulation  run. 

D.  DATA  ANALYSIS  AND  INTERPRETATION 

Several  simulation  runs  were  conducted.  Each  run  produced  a  single  file  of  raw 
data,  which  was  then  imported  into  an  Excel  spreadsheet.  Excel  was  used  to  separate  the 
data  from  each  of  the  three  types  of  events  and  generate  time  graphs  showing  the 
progress  of  the  relevant  variables.  At  this  stage,  the  initial  and  final  transient  periods  were 
easily  identified.  Since  we  are  only  interested  on  the  steady-state  performance,  data 
collected  over  those  two  periods  were  deleted.  Erom  remaining  data,  it  was  then  possible 
to  obtain  two  types  of  information;  a  graphic  representation  of  variables  plotted  against 
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time  and  calculated  average  values  during  that  sample  interval.  The  following  sections 
present  the  data  as  described. 


1.  Borrowing  Sensitivity  Test  With  Network  A 


For  the  purpose  of  this  test,  the  interface  2..1  of  network  A  shown  in  Figure  6.1 
was  subject  to  five  different  load  conditions.  Table  6.1  below  shows  the  interface  state  at 
startup,  i.e.  with  no  traffic  traversing  it. 


Bandwidth 

Service  Level 

Base 

Allocation 

Available 

Available  with 
borrowing 

Borrowing 

Capacity 

SAAM  Control 

100 

100 

100 

0 

IntServ 

300 

600 

680 

120 

DiffServ 

200 

500 

620 

80 

Best  Effort 

100 

100 

100 

0 

Unallocated 

300 

Total  BW 

1000 

Table  6. 1  Interface  configuration  at  startup. 

Table  6.2  shows  the  flow  characterization  for  load  A.  Different  network  loads 
were  achieved  by  changing  the  flow  duration  for  IntServ,  which  implicitly  affects  the 
projected  number  of  active  IntServ  flows.  Flow  requests  for  each  of  the  Difffierv  and 
IntServ  services  were  generated  using  a  Poisson  distribution,  and  the  flow  durations 
modeled  with  a  normal  distribution.  Table  6.3  summarizes  the  projected  flow  requests  for 
the  five  different  loads,  with  ensuing  traffic  going  from  router  A  to  router  E. 


Parameter 

IntServ 

DiflServ 

Inter-arrival  time  (sec) 

I 

10 

Duration  -  mean  (sec) 

100 

200 

Duration  -  sigma  (sec) 

10 

10 

Bandwidth  (kbps) 

6 

7 

Table  6.2  Characterization  of  individual  flows 
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For  each  of  the  five  loads,  four  different  random  generation  seeds  were  used.  For 
each  seed,  the  simulation  was  run  twice,  first  with  inter-service  borrowing  enabled  and 
then  with  the  borrowing  disabled.  Therefore,  there  were  a  total  of  8  simulation  runs  per 
load.  Appendix  D  contains  summary  information  for  each  of  the  described  test 
conditions. 


Projected  Data 

Load 

Active  Flows 

Bandwidth  Request  (Kbps) 

IntServ 

Difffierv 

IntServ 

DifiBerv 

A 

100 

20 

600 

140 

B 

104 

20 

624 

140 

C 

108 

20 

648 

140 

D 

112 

20 

672 

140 

E 

116 

20 

696 

140 

Table  6.3  Characterization  of  individual  flows 


A  single  simulation  run  was  done  over  a  period  of  1000  seconds,  which  allowed 
over  a  1,2000  flow  requests  to  be  processed  for  both  services.  Figure  6.4  shows  an 
example  of  a  time-graph  plotted  from  raw  data  obtained  for  load  A,  without  inter-service 
borrowing  and  with  a  seed  of  100.  When  all  runs  were  done,  the  steady-state  interval  was 
considered  between  250  and  1000  seconds.  This  was  so  since  in  all  test  cases  after  250 
seconds  service  level  loads  were  observed  to  have  reached  a  steady  state. 
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Simulation  Run 
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Figure  6.4  Raw  data  from  a  single  simulation  run. 

Having  defined  the  steady-state  interval  for  all  loads,  then  the  sample  respective 
sample  data  was  extracted  from  the  original  data.  Figure  6.5  below  shows  two  graphs 
plotted  from  data  of  the  same  load  condition  of  figure  6.4.  The  two  borrowing  states  are 
represented.  As  can  be  observed,  only  the  steady-state  interval  is  shown.  Each  graphs 
shows  the  effective  interface  load  per  service  level  (IntServ  and  DiflEerv)  plus 
unallocated  bandwidth.  Additionally,  the  rejection  rates  per  service  level  are  also 
represented. 
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Interface  Load 

Borrowing  Enabled 


Interface  Load 

Borrowing  Disabled 


Figure  6.5  Interface  2..  1  load  during  two  simulation  runs,  with  and  without  inter¬ 
service  borrowing 

As  previously  stated,  simulation  data  details  can  be  found  in  Appendix  D.  Graphs 
in  Figures  6.6  and  6.7  summarize  the  findings.  For  an  increasing  load  of  IntServ  and  as 
expected,  the  flow  rejection  rate  of  IntServ  also  increases.  Note  that  the  flow  rejection 
rates  were  obtained  by  averaging  the  results  over  four  runs  with  different  random 
generator  seeds.  In  all  load  cases,  the  impact  of  inter-service  borrowing  is  extremely 
significant.  It  is  also  noted  that  the  gains  of  using  inter-service  borrowing  slightly 
decrease  with  the  increase  of  the  network  load  which  is  explained  with  the  saturation  of 
the  borrowing  capacity  made  available  by  the  other  service. 
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IntServ  Rejections 


ABODE 
Simulation  Runs  Series 

Figure  6.6  Comparative  analysis  of  borrowing  versus  no  borrowing,  for  inereasing 

network  load 


Rejection  Rate  Improvement 

(%) 


ABODE 


Simulation  Runs  Series 

Figure  6.7  Reduetion  of  IntServ  flow  rejection  rate  as  network  load  increases 

2,  Network  B  Test 

For  the  purpose  of  this  test,  the  PibTester  was  adapted  to  generate  flow  requests 
from  a  random  source  to  a  random  destination,  among  all  three  nodes  (A,  B  and  C).  Since 
the  test  objective  was  to  check  the  PIB  function  when  more  alternate  paths  are  available, 
there  was  no  need  to  collect  data  at  the  interface  level.  With  the  simulation  running,  the 
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PibTester  GUI,  as  presented  in  figure  6.1,  offers  the  option  of  inspeeting  the  status  of 
individual  paths  and  interfaees  at  any  point  during  the  simulation.  This  option  was  used 
to  verify  the  funetionalities  of  the  PIB.  The  observed  results  were  as  expeeted. 
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VII.  CONCLUSIONS  AND  RECOMMENDATIONS 


This  thesis  demonstrated  the  feasibility  of  effieient  management  of  network 
resources  while  providing  support  for  different  classes  of  QoS  traffic.  The  novel  inter¬ 
service  borrowing  mechanism  was  developed  and  integrated  with  SAAM.  This  new 
mechanism  results  in  a  more  dynamic  and  adaptive  link  share  among  supported  services. 
The  test  and  evaluation  results  show  evidence  of  a  significant  improvement  of  the  overall 
network  resource  utilization.  The  new  resource  management  concept  further  strengthens 
the  goal  of  SAAM  to  intelligently  manage  network  resources.  Some  key  aspects  of  this 
study  are  covered  below. 

A,  PATH  INFORMATION  BASE  REDESIGN 

The  implementation  of  inter-service  borrowing  in  PIB  involved  changes  in  every 
aspect  of  the  PIB  internals.  Although  some  new  data  members  were  required  to  be  added 
to  existing  data  structure,  some  internal  algorithms  were  completely  redesigned  with 
efficiency  in  mind.  One  of  such  modifications  is  related  with  processing  LSA  messages 
and  propagating  interface  updates.  Despite  the  newly  added  functionality  and  associated 
complexity,  the  revised  PIB  is  considered  more  robust  and  more  efficient. 

B,  PIB  TEST 

The  test  drive  specifically  developed  for  this  thesis  proved  very  valuable.  The  PIB 
tester  was  capable  of  generating  not  only  a  continuous  stream  of  flow  requests  but  also 
the  required  Link  Status  Advertisement  messages  with  the  adequate  periodicity.  The 
friendly  and  flexible  interface  of  the  tester  allowed  for  a  large  number  of  testing 
conditions  and  network  loads  to  be  run  against  PIB.  For  the  first  time,  it  was  possible  to 
stress  test  all  the  functional  parts  of  PIB  at  the  same  time.  Each  test  run  generated  large 
amounts  of  data.  Processing  such  large  quantities  of  data,  validating  them  and  extracting 
relevant  information  was  at  some  point  overwhelming  for  the  testing  platform.  However, 
obtained  results  were  very  satisfactory  which  helps  to  strengthen  the  SAAM  concept. 
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C.  AREAS  FOR  FURTHER  STUDY 

1.  Link  State  Advertisement  Cycle 

The  LSA  cycle  duration  should  not  be  arbitrarily  selected.  One  of  the  major 
processing  overheads  within  PIB  is  the  processing  of  LSAs.  If  routers  advertise  the  state 
of  their  interfaces  very  frequently  and  if  the  SAAM  region  contains  a  large  number  of 
routers/interfaces,  the  burden  of  processing  LSAs  may  impact  the  performance  of  PIB.  In 
such  cases,  flow  requests  may  have  to  be  buffered  while  waiting  for  an  LSA  cycle  to 
complete.  However,  a  short  LSA  cycle  also  means  that  the  PIB  state  is  oftener  refreshed, 
thus  maintaining  a  more  accurate  image  of  its  network.  If  otherwise  the  LSA  cycle  is 
made  too  long,  PIB  state  is  less  accurate  which  may  eventually  cause  incorrect  admission 
of  new  flows,  leading  to  buffer  overruns  at  routers.  The  LSA  cycle  need  not  to  be 
constant  and  could  vary  depending  upon  network  conditions.  Additionally,  some  kind  of 
prioritization  among  flow  requests  and  LSA  messages  arriving  to  PIB  should  be 
implemented.  The  tuning  of  the  LSA  cycle  is  therefore  an  important  PIB  function  and 
should  therefore  be  in  the  scope  of  further  study  of  SAAM. 

2.  Accurate  Link  State  Advertisement 

Whatever  modifications  are  made  within  the  Path  Information  Base,  its  function  is 
highly  dependent  on  the  external  two  inputs  it  receives  -  the  Link  State  Advertisement 
and  the  Flow  Request  messages.  Flow  requests  simply  translate  the  demand  of  resources 
from  user  applications  and  is  already  working  as  expected.  However,  LSA  generation  is 
not  yet  fully  implemented  by  SAAM  routers.  The  Link  Sate  Monitor  is  the  module 
responsible  for  monitoring  interfaces  and  advertising  their  state  based  on  observation  of 
real  traffic.  Current  implementation  of  the  Link  State  Monitor  reports  zero  interface 
utilization  or  other  inaccurate  value  regardless  of  traffic  flows.  Once  these  values  arrive 
to  PIB  in  LSA  messages,  they  are  subsequently  used  to  update  PIB  status.  Because  of  the 
inaccurate  state  of  PIB,  the  admission  control  and  resource  reservation  mechanisms  of 
PIB  in  most  cases  will  perform  incorrectly.  In  order  to  make  the  best  use  of  current 
functionality  of  PIB  it  is  highly  desirable  that  LSA  generation  in  SAAM  be  fully 
implemented. 
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3,  SAAM  Network  Management 

Every  component  deployed  in  a  network  is  typically  operated  either  locally 
through  console  access  or  remotely  using  network  management  applications.  These 
applications  communicate  with  network  components  to  query  their  state  or  to  set 
functional  parameters  using  an  application  layer  protocol  such  as  Simple  Network 
Management  Protocol  (SNMP).  The  PIB  within  a  SAAM  server  has  evolved  to  a  stage 
where  some  of  its  behavior  can  be  changed  during  normal  operation.  For  instance,  the 
inter-service  borrowing  capacity  can  be  turned  on  or  off  during  normal  operation.  An  area 
of  potential  study  would  be  the  design  and  implementation  of  an  application  that  was  able 
to  generate  SNMP  traffic  destined  to  specific  SAAM  modules/agents  such  as  the  SAAM 
server  and  the  PIB,  to  be  able  to  perform  network  management  functions. 
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APPENDIX  A  MILITARY  RELEVANCE  OF  SAAM  PROJECT 


A,  SUMMARY 

The  vision  for  future  joint  war  fighting  of  US  military  is  deseribed  in  Joint  Vision 
2020  (JV2020).  The  eoneept  of  network-centrie  warfare  (NCW),  first  eonveyed  in  the 
JV2010  and  carried  forward  in  JV2020,  represents  a  fundamental  shift  from  the  previous 
platform-centric  warfare.  Interoperability  with  external  agencies  and  among  forces  of  the 
allied  nations  is  a  growing  necessity  as  recently  proved  with  the  combined  NATO 
operations  in  the  Balkans.  Military  operations  in  the  current  information  age  are 
organized  around  the  NCW  concept,  through  which  information  superiority  translates 
into  increased  combat  power.  NCW  is  enabled  by  effectively  networking  sensors, 
decision  makers  and  shooters  to  achieve  shared  awareness,  increased  speed  of  command 
and  high  levels  of  self-synchronization. 

The  NCW  environment  creates  a  wide  range  of  network  service  requirements, 
only  possible  to  meet  through  active  and  adaptive  networks.  Server  and  Agent  Based 
Active  network  Management  (SAAM)  is  one  of  such  networks  being  prototyped  at  the 
Naval  Postgraduate  School.  This  document  addresses  some  key  enabler  technologies  of 
SAAM,  which  illustrate  the  importance  of  SAAM  in  the  context  of  the  NCW 
environment. 

B,  DISCUSSION 

Joint  Vision  2020  builds  on  the  foundation  of  Joint  Vision  2010.  Several  strategic 
principles  and  operational  concepts  of  JV2020  are  technically  addressed  by  SAAM. 

1.  Global  Information  Grid 

JV2020  develops  a  concept  labeled  Global  Information  Grid  (GID).  The  GID 
requires  a  network-centric  environment  that  integrates  traditional  forms  of  information 
operations  with  sophisticated  all-source  intelligence,  surveillance,  and  reconnaissance  in 
a  fully  synchronized  information  operation.  SAAM  supports  dynamic,  non-intrusive 
service  deployment  with  which  software  agents  can  be  dynamically  deployed  across  the 
GID  and  configured  to  perform  various  tasks  on  demand. 
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The  GID  will  be  a  globally  intereonneeted,  end-to-end  set  of  information 
eapabilities,  assoeiated  proeesses,  and  people  to  manage  and  provide  information  on 
demand  to  warfighters,  poliey  makers,  and  support  personnel.  The  SAAM  hierarehieal 
arehiteeture  and  auto-eonfiguration  protoeol  provide  a  meehanism  for  SAAM  to  seale 
from  single  SAAM  regions  into  a  global  information  infrastrueture.  Additionally,  the 
quality-of-serviee  (QoS)  model  of  SAAM  supports  guaranteed  serviees,  eapable  of  delay 
guarantees  to  individual  network  users,  whieh  is  an  important  guarantee  for  applieations 
that  rely  on  synehronization. 

The  GID  needs  to  eontinue  funetioning  when  under  hostile  attaeks.  The 
eentralized  SAAM  approaeh  makes  SAAM  servers  a  privileged  network  player 
possessing  the  broadest  possible  view  of  distributed  GID  resourees.  With  sueh  visibility 
over  its  resourees,  SAAM  servers  are  able  to  take  a  pro-aetive  approaeh  to  fault  toleranee 
by  ereating  optimal  alternative  paths  ahead  of  time.  Under  malieious  aggression,  SAAM 
immediately  redireets  affeeted  flows  to  these  alternative  paths,  whieh  happens  seamlessly 
to  network  users.  The  survivability  of  the  GID  is  further  enhaneed  with  SAAM’s  ability 
of  reloeating  server  funetionalities  to  a  different  physieal  network  node  rapidly  without 
signifieant  serviee  degradation.  There  is  no  single  point  of  failure. 

2,  Innovation 

JV2020  identifies  teehnieal  innovation  as  a  vital  eomponent  of  the  revolution  in 
future  warfare.  SAAM  is  an  agent-based  network,  whieh  means  that  new  funetionality 
ean  be  easily  deployed  on  the  fly.  New  SAAM  agents  ean  extend  or  replaee  the  funetions 
of  existing  agents.  Onee  the  SAAM  network  infrastrueture  is  deployed,  the  introduetion 
of  network  ehanges,  new  requirements,  or  added  funetionalities  ean  be  easily 
aeeommodated. 

3,  Interoperability 

Interoperability  is  the  ability  to  provide  serviees  to  and  from  other  systems.  It  is  a 
mandate  for  the  joint  foree  of  2020,  espeeially  in  terms  of  oommunieations,  and 
information  sharing.  Multinational  operations  like  reeent  NATO  operations  in  the 
Balkans,  onee  again  demonstrated  the  importanee  of  interoperability.  Information 
systems  and  equipment  that  enable  a  eommon  relevant  operational  pieture  must  work 
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from  shared  networks  that  can  be  accessed  by  any  authorized  participant  regardless  of  the 
location. 

The  centralized  approach  of  SAAM  to  network  management  provides  for  a 
controlled  access  to  network  resources.  Identification  and  authentication  of  network  users 
is  supported  and  it  provides  the  means  for  implementing  secure  communication  channels. 
Additionally,  SAAM  agents  can  be  tailored  to  provide  the  bridge  between  the  varying 
levels  of  technology  of  the  potential  multinational  allied  nations.  Specially  configured 
agents  may  be  deployed  to  edge  nodes  that  interconnect  incompatible  system  with  the 
shared  network.  These  agents  perform  all  required  traffic  adaptation,  thus  supporting 
interoperability. 

4.  Communication  Command  and  Control 

NCW  requires  the  coexistence  of  multiple  levels  of  traffic  priority  for  the 
Communication,  Command  and  Control  (C3)  channels.  The  SAAM  QoS  model  enables 
applications  to  specify  their  QoS  requirements,  including  throughput  and  delay.  SAAM 
resources  are  allocated  hierarchically  and  the  best  performing  QoS  routes  can  be  easily 
assigned  to  the  highest  priority  C3  channels,  for  instance,  between  front  line  units  and  C3 
centers. 

SAAM  implements  a  better-fit  QoS  model  for  battle.  With  the  per-fiow 
management  capability,  SAAM  can  establish  different  priorities  for  different  flows. 
Different  conversations  may  have  different  priorities.  Battle  scenario  is  constantly 
changing,  and  so  is  supporting  network  infrastructure  and  network  users.  Network 
resources  are  limited.  Because  battle  scenarios  are  frequently  in  remote  and  adverse 
locations,  deployment  of  a  network  for  supporting  NCW  in  those  scenarios  requires 
adequate  optimization  of  such  limited  resources.  The  intelligent  network  management 
approach  of  SAAM  is  perfectly  suited  for  those  conditions,  since  allocation  of  resources 
is  based  on  both  traffic  profile  and  changing  network  conditions.  Whenever  QoS 
performance  of  some  QoS  traffic  is  affected,  SAAM  network  automatically  and 
dynamically  adapts  to  optimize  available  resources  and,  equally  important,  ensures  that 
high  priority  traffic  is  favored  whenever  network  conditions  degrade. 
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c. 


RECOMMENDATION 


The  work  of  this  thesis  greatly  eontributes  for  the  improvement  of  the  SAAM 
eoneept  and  further  extends  the  potential  of  SAAM  beeoming  a  solution  to  all  major 
teehnieal  problems  posed  by  NCW. 
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APPENDIX  B  PIB  SOURCE  CODE 


-  PIB  redesigned  to  provide  for  inter-service 
borrowing . 

All  code  was  reviewed  and  cleaned.  Aditionally, 
inner  class  RoutingAlgorithm  was  added  to  encapsulate 
the  routing  algorithm  behavior. 

-  Rewrite  setupPath:  vInterfaceSequence  only  contains 
outbound  interfaces 

-  Redesign  eliminating  non-final  static  data  structs 

-  Reviewed  code  and  cleaned  up; 
see  comments  prefixed  by  [GX] 

-  Created 


package  saam. server; 


import  saam. util.*; 

import  saam.net.*; 

import  saam. router . Interface ; 

import  saam. message .* ; 

import  saam. server . Server ; 

import  saam. server . dif f serv . SLS ; 


import  java .util . * ; 
import  java.io.*; 
import  j  ava . net . * ; 
import  java.awt.*; 
import  j ava . awt . event .* ; 
import  j  ava . text . * ; 
import  j avax .swing.*; 


/  *  * 

*  PathInformationBase  develops  a  data  structure  to  store  to  current  set  of 

*  paths  between  all  routes  participating  in  the  Server  and  Agent  based  Active 

*  network  Management  (SAAM)  autonomous  system. 

* 

*  Initial  developed  by  Dao  Chang  Kuo,  and  John  Gibson  with  the  assistance  of 

*  Charlie  Grassi  and  Kostas  Sambanis  for  CS4552,  Spring  2000. 

*/ 

public  class  BasePIB  extends  PathInformationBase! 
y  *  * 

*  Runs  PIB  under  testing  mode.  A  BasePIB  tester  console  (PibTester  class) 

*  associated  with  the  Path  Information  Base  is  started.  The  tester  has  its 

*  own  GUI  and  allows  for  direct  comunnication  with  PIB  for  sending  Flow 

*  Request  and  LSA  messages  or  quering  PIB  state,  like  interface  or  path 

*  status,  toggle  inter-service  borrowing  on/off,  etc. 

*/ 

private  final  boolean  TESTING_MODE  =  true; 
y  *  * 

*  The  pibTest  is  used  only  in  test  mode.  It  will  launch  a  separated  gui 

*  console. 

*/ 

private  Thread  pibTest; 

/  *  * 

*  For  the  level  of  display  detail.  If  set  to  true,  the  pib  will  display  in 

*  its  gui  more  detailed  information.  Should  be  used  PIB  diagnosis. 

*/ 

private  final  boolean  DISPLAY_FULL_DETAIL  =  false; 

/  *  * 

*  The  default  state  of  interservice-borrowing  capability  (true  for  enable) . 
*/ 
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private  final  boolean  INTERSERVICE_BORROWING_DEFAULT  =  true; 

/  *  * 

*  The  borrowing  threshold  is  a  percentage  of  the  a  service  level  base 

*  allocation  bandwidth,  which  represents  the  amount  of  bandwidth  a  service 

*  will  never  make  available  for  inter-service  borrowing. 

*/ 

protected  final  float  DEFAULT_BORROWING_THRESHOLD  =  0,60f; 

/  *  * 

*  This  offset  is  obtained  from  the  inter-service  borrowing  algorithm,  after 

*  applying  the  quantiles  for  the  normal  distribution.  This  value  is  used  to 

*  compute  the  maximum  borrowing  capacity  of  a  service  level,  and  is  a 

*  function  of  probability  of  request  conflict  among  service  levels. 

*  For  instance,  for  the  probability  of  95%,  the  offset  becomes  0.164. 

*/ 

protected  final  float  BORROWING_PROBABILITY_OFFSET  =  0.164f; 

/  *  * 

*  The  routing  algorithm  module. 

*/ 

private  RoutingAlgorithm  routingAlgorithm; 

/  *  * 

*  The  current  PIB  version  information. 

*/ 

public  final  String  strPIB_VERSION  = 

" - \n"  + 

"  SAAM  Network  -  Path  Information  Base\n"  + 

"  Version  2.0b  August  2001\n"  + 

" - 


/  *  * 

*  The  number  of  different  service  levels  supported 
*/ 

public  final  int  NUM_OF_SERVICE_LEVELS  =  5; 

/  *  * 

*  SAAM  control  channel  -  SAAM  service  level  0 
*/ 

public  static  final  byte  CTRL_CHN  =  0; 
y  *  * 

*  Integrated  Services  -  SAAM  service  level  1 
*/ 

public  static  final  byte  INT_SERV  =  1; 

/  *  * 

*  Differentiated  Services  -  SAAM  service  level  2 
*/ 

public  static  final  byte  DIFF_SERV  =  2; 

/  *  * 

*  Best  Effort  -  SAAM  service  level  3 
*/ 

public  static  final  byte  BEST_EFFORT  =  3; 

/  *  * 

*  Out  of  Profile  -  -  SAAM  service  level  4 

*/ 

public  static  final  byte  OUT_PROFILE  =  4; 

/  *  * 

*  Maximum  and  minimum  flow  ID  numbers  (8-bit  field) 

*/ 

public  final  int  MAX_FLOW_ID  =  255; 
public  final  int  MIN_FLOW_ID  =  1; 

public  static  int  newFlowID  =  0;  //[GX] :  each  path  should  have  own  counter 

y  *  * 

*  This  is  a  magic  number  used  for  the  Best  Effort  admission  algorithm. 
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*  For  every  newly  admited,  the  available  bandwdith  for  Best  Services  is 

*  reduced  by  this  amount.  [PS]  -  the  BE  admission  procedure  needs  to  be 

*  revised. 

*/ 

public  static  int  Best_Ef fort_Allocated_Bandwidth  =  50000; 

/  *  * 

*  The  current  state  of  pib  interservice  borrowing  capability. 

*/ 

private  boolean  isBorrowingEnabled; 

/  *  * 

*  The  current  inter-service  borrowing  threshold. 

*/ 

private  double  borrowingThreshold; 

/  *  * 

*  Initial  base  allocation  of  interface  bandwidth  among  all  service  levels. 

*  Summation  of  all  shares  must  be  less  or  equal  to  l.Of. 

V 

public  final  float  afBASE_ALLOCATION [ ]  =  {O.lf,  0.3f,  0.2f,  O.lf,  O.Of}; 

/  *  * 

*  Network  load  factor  for  each  of  the  specified  service  levels.  Load  factor 

*  is  used  to  specify  the  maximum  amount  of  network  resources  (bandwidth) 

*  that  might  be  in  use  at  any  time.  The  individual  service  load  factor 

*  are  values  between  0  and  1.0. 

*/ 

public  final  float  afLOAD_FACTOR [ ]  =  {l.Of,  l.Of,  l.Of,  l.Of,  l.Of}; 

/  *  * 

*  Utilization  update  threshold.  This  value  multiplied  with  the  current  unit 

*  of  utilization  (ServiceSA.UTIL_UNIT)  yields  the  level  of  utilization 

*  variation,  above  which  the  utilization  report  (ISA)  will  change  trigger 

*  an  interface  update. 

*/ 

public  final  byte  thresholdUtilization  =  5;  //times  ServiceSA.UTIL_UNIT  (0.01%) 
/  *  * 

*  Delay  update  threshold.  Delay  variation  threshold  above  which,  a  new  delay 

*  report  (ISA)  will  actually  trigger  an  interface  update. 

*/ 

public  final  short  thresholdDelay  =  5; 

y  *  * 

*  Loss  Rate  update  threshold.  Loss  Rate  variation  threshold  above  which,  a 

*  new  loss  rate  report  (ISA)  will  actually  trigger  an  interface  update. 

*/ 

public  final  short  thresholdLossRate  =  5; 

/  *  * 

*  Next  path  ID.  Holds  the  path  ID  number  to  be  assigned  to  application 

*  flows.  Paths  0  to  64  are  reserved  for  signaling  channels. 

*/ 

public  static  short  iNextPathID  =  65; 

/  *  * 

*  Next  node  ID.  Holds  the  value  of  the  next  sequential  node  identification 

*  number.  Defaults  to  smallest  non-negative  integer  value  upon  PIB. 

*  initialization 

*/ 

public  static  int  iNextNodelD  =  0; 

/  *  * 

*  Maximum  number  of  nodes.  Holds  the  maximum  number  of  nodes  allowed 

*  within  a  SAAM  region. 

*/ 

public  final  int  MAX_NODE_NUMBER  =  30; 
y  *  * 

*  Holds  the  maximum  number  of  hops  any  single  path  can  make. 
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*/ 

public  final  int  MAX_HOP_COUNT  =8+1; 

/  *  * 

*  To  keep  track  of  the  number  of  LSA  messages  received 
*/ 

private  static  int  iLsaCounter  =  0; 
y  *  * 

*  The  Server  instance. 

*/ 

private  Server  myServer; 

/  *  * 

*  The  GUI  display  window  for  PIB. 

*/ 

private  SAAMRouterGui  display; 

/  *  * 

*  For  number  formating  purposes  used  in  PIB  gui. 

*/ 

private  DecimalFormat  df; 

/  *  * 

*  A  three-dimensional  array  of  hashtables  containing  all  path  IDs  between  a 

*  source  and  destination  router  pair  for  specific  hop  count. 

*/ 

Hashtable  aPI  [  ]  [  ]  [  ]  ; 

/  *  * 

*  A  table,  keyed  by  the  router's  largest  IPv6  address,  associating  the  router 

*  with  a  unique  node  iD  for  the  life  of  the  Path  Information  Base  structure. 

*  While  the  router's  ID,  as  determined  by  its  assigned  IPv6  addresses,  may 

*  change,  its  assigned  Node  ID  remains  constant  unless  the  PIB  is  reset. 

*/ 

Hashtable  htRouterlDtoNodelD; 

/  *  * 

*  A  reverse  look-up  table,  keyed  by  the  Integer  Node  ID,  used  to  identify  a 

*  router's  IPv6  based  name. 

*/ 

Hashtable  htNodelDtoRouterlD; 

/  *  * 

*  A  look-up  table,  keyed  by  the  router's  IPv6  based  ID,  which  contains  all 

*  the  active  interfaces  for  a  corresponding  router.  The  interfaces  are 

*  themselves  contained  in  a  hashtable,  keyed  by  the  interface's  IPv6  address, 

*  which  maps  to  the  IPv6  address  byte  array,  allowing  rapid  search,  insert, 

*  and  removal  of  interfaces  from  a  router. 

*/ 

Hashtable  htRouterInterfaceMap; 
y  *  * 

*  A  look-up  table,  keyed  by  the  interface's  IPv6  address  byte  array,  which 

*  holds  the  Interfaceinfo  for  the  corresponding  interface. 

*/ 

Hashtable  htinterfaces; 

/  *  * 

*  A  look-up  table,  keyed  by  iPathID,  which  enables  rapid  access  to  all  paths 

*  that  have  been  established.  The  path  objects  are  store  within  the  table 

*  elements. 

*/ 

Hashtable  htPaths; 

/  *  * 

*  A  look-up  table,  used  for  Differentiated  Service  key  is  the  userlD,  object 

*  stored  in  this  table  is  SLS  object. 

*/ 

Hashtable  htUserSLSs; 

/  *  * 
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*  A  vector  to  store  the  collection  of  interfaces  traversed  and  affected  after 

*  a  single  flow  request.  Used  in  conjuntion  with  the  PibTester  class  for  test 

*  purposes  only  (when  PIB  is  test  mode) . 

*/ 

protected  Vector  vIFacesTraversed; 

/  *  * 

*  aPIIndex  Class.  This  class  makes  an  object  of  the  index  values  for  a  given 

*  element  of  the  array  of  path  id  hashtables.  The  index  order  is:  Source 

*  Node,  Destinaytion  Node,  and  Hop  Count  This  object  cross  references  a 

*  path  to  the  aPI  element  which  contains  it. 

*/ 

private  class  aPIIndex 

{ 

/  *  * 

*  The  Node  ID  for  the  source  router 
*/ 

Integer  iSource; 
y  *  * 

*  The  Node  ID  of  the  destination  router 
*/ 

Integer  iDestination; 
y  *  * 

*  The  number  of  nodes  each  path  takes 
*/ 

int  iHopCount; 

/  *  * 

*  Constructs  an  aPIndex  object  with  the  provided  parameters. 

*  @param  iS 

*  @param  iD 

*  @param  iHC 
*/ 

public  aPIIndex  (Integer  iS,  Integer  iD,  int  iHC) 

{ 

iSource  =  iS;  iDestination  =  iD;  iHopCount  =  iHC;} 

/  *  * 

*  Gets  the  node  ID  of  the  source  router 

*  @return  the  node  ID  of  the  source  router 
*/ 

public  Integer  getSourceO 

{ 

return  iSource; 

} 


/  *  * 

*  Gets  the  node  ID  of  the  destination  router 

*  @return  the  node  ID  of  the  destination  router 
*/ 

public  Integer  getDestination ( ) 

{ 

return  iDestination; 

} 


/  *  * 

*  Gest  the  hop  count 

*  @return  the  hop  count 
*/ 

public  int  getHopCount ( ) 

{ 

return  iHopCount; 

} 

}  //  End  of  aPIIndex  class 


y  *  * 

*  The  path  class  creates  objects  which  represent  the  key  aspects  of  a  path. 
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*  -  PathID,  an  class-wrapped  representation  of  a  primitive-type  integer  (the 

*  class  wrapper  is  necessary  for  storing  the  pathID  in  a  hashtable  object 

*  -  aPIIndex  object  to  cross  reference  the  path  to  the  array  of  all  path  IDs 

*  -  vNodeSequence  which  contains  all  the  nodes  a  path  traverses,  listed 

*  beginning  with  the  destination  and  ending  with  the  source. 

*  -  vinterf aceSequence  object  containing  the  sequence,  in  reverse  order  of 

*  all  interfaces  a  path  traverses. 

*/ 

private  class  Path 

{ 

y  *  * 

*  The  path  ID  wrapped  as  an  object  for  use  in  hashtables. 

V 

Integer  iPathID; 

/  *  * 

*  If  routing  entries  have  been  created  in  routers  to  support  the  path 
*/ 

boolean  bCreated  =  false; 

/  *  * 

*  Used  to  flag  paths  that  change  as  a  consequence  of  a  new  flow  admission, 

*  easing  the  process  of  QoS  refreshing  of  all  interfaces/paths  directly 

*  and  indirectly  involved 
*/ 


y  *  * 

*  The  mirror  path.  For  quick  look-up,  it  keeps  a  reference  to  the  mirror, 

*  where  source  and  destination  are  swapped. 

*/ 

Path  mirrorPath; 

/  *  * 

*  Cross  reference  for  the  path  to  the  array  of  path  information  objects 
*/ 

aPIIndex  objaPIIndex; 

/  *  * 

*  The  node  sequence  vector.  Contains  the  sequence  of  nodes  the  path 

*  traverses,  from  destination  to  source 
*/ 

Vector  vNodeSequence; 

/  *  * 

*  The  interface  sequence  vector.  Contains  the  sequence  of  outbound 

*  interfaces  traversed  by  this  path,  listed  from  destination  node  to 

*  source  node. 

*/ 

Vector  vInterfaceSequence; 

/  *  * 

*  The  array  of  path  QoS  objects,  indexed  by  the  service  level  index. 

*/ 

PathQoS  objPathQoS[]  =  new  PathQoS [NUM_OF_SERVICE_LEVELS  -  1]; 

/  *  * 

*  For  the  flow  IDs. 

*/ 

int  iNewFlowID  =  MIN_FLOW_ID  -  1; 
y  *  * 

*  Look-up  table  of  flows  assigned  to  each  service  level  on  a  path.  Each 

*  hashtable  is  keyed  by  the  flow  ID  and  pairs  the  actual  flow  ID  with  the 

*  key  generated  by  the  hash  scheme.  The  array  of  hashtables  is  indexed  by 

*  the  service  level. 

*/ 

Hashtable  ahtFlows[]  =  new  Hashtable [NUM_OF_SERVICE_LEVELS  -  1]; 

/  *  * 

*  Constructs  a  single-hop  path  between  a  given  source  node  and  a  destination 

*  node . 
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*  @param  ilD  the  PathID  to  be  assigned  to  the  new  path. 

*  @param  index  cross  reference  to  Path  Info  array. 

*  @param  baInterfacelD  the  IPv6  address  of  the  outbound  interface. 

*  @param  baNeighborInterfacelD  the  IPv6  address  of  the  neighbor  interface. 

*  @param  iBandwidth  the  interface  bandwidth. 

*/ 

public  Path  ( 

Integer  ilD, 
aPIIndex  index, 

IPv6Address  baInterfacelD, 

IPv6Address  baNeighborInterfacelD, 
int  iBandwidth) 

{ 

iPathID  =  new  Integer (ilD. intValue ()) ; 
objaPIIndex  =  index; 

vNodeSequence  =  new  Vector ();  //  For  the  node  sequence 

vNodeSequence . addElement ( index . get Destination ( ) ) ; 
vNodeSequence . addElement (index . get Source ( ) )  ; 

vInterfaceSequence  =  new  Vector  ();  //  For  the  interface  sequence 

//Only  outbound  interfaces  is  added  to  the  interface  sequence 
vInterfaceSequence . addElement (baInterfacelD) ; 

for  (int  si  =  0;  si  <  NUM_OF_SERVICE_LEVELS  -  1;  sl++) 

{ 

//  Initalize  QoS  for  each  in-profile  service  level 
objPathQoS  [si]  =  new  PathQoSO; 

//  Allocate  an  empty  hashtable  for  flowIDs 
ahtFlows[sl]  =  new  Hashtable  (  ); 

} 


ref reshPathQoS (this) ; 

}  //  End  Path ( )  constructor  for  single-hop  path 


/  *  * 

*  Constructs  a  new  multi-hop  path  between  a  given  source  node  and  and 

*  destination  node,  from  a  given  existing  path  and  appending  from  front 

*  (source) . 

*  @param  iNewPathID  the  PathID  to  be  assigned  to  the  new  path 

*  @param  iOldPathID  the  PathID  of  the  old  path  having  the  new  source  node 

*  appended 

*  @param  index  the  aPIIndex. 

*  @param  baInterfacelD  the  IPv6  address  of  the  outbound  interface. 

*  @param  baNeighborInterfacelD  the  IPv6  address  of  the  neighbor  interface 

*  (inbound) . 

*  @param  iBandwidth  the  interface  total  bandwidth. 

*/ 

public  Path  ( 

Integer  iNewPathID, 

Integer  iOldPathID, 
aPIIndex  index, 

IPv6Address  baInterfacelD, 

IPv6Address  baNeighborInterfacelD, 
int  iBandwidth) 

{ 

iPathID  =  new  Integer (iNewPathID. intValue ()) ; 
objaPIIndex  =  index; 

//  Extract  the  old  path  from  iOldPathID 
Path  oldPath  =  (Path)  htPaths . get ( iOldPathID) ; 

//  Stores  the  sequence  of  nodes  for  this  path 
vNodeSequence  =  new  Vector (); 

//  Copy  the  old  path's  nodes 

vNodeSequence  =  (Vector)  oldPath .vNodeSequence . clone () ; 
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//  Simply  add  the  new  source 

vNodeSequence . addElement ( index . getSour ce ( ) ) ; 

//  Stores  the  sequence  of  interfaces  for  this  path 
vInterfaceSequence  =  new  Vector  (); 

//  Copy  the  old  interfaces  sequence 

vInterfaceSequence  =  (Vector)  oldPath . vInterfaceSequence . clone () ; 

//  Only  the  neighbor  interface  need  to  be  added.  Since  the  node  is  added 
//  at  the  front,  the  neighbor  interface  is  an  outbound  interface  to  this 
//  path.  The  parameter  list  of  this  constructor  does  not  need 
//  baInterfacelD 

vInterfaceSequence . addElement (baInterfacelD) ; 

for  (int  si  =  0;  si  <  NUM_OF_SERVICE_LEVELS  -  1;  sl++) 

{ 

//  Initalize  Qos  for  each  service  level 
objPathQoS  [si]  =  new  PathQoSO; 

//  Allocate  an  empty  hashtable  for  flowIDs 
ahtFlows[sl]  =  new  Hashtable  (  ) ; 

}  //  End  for-loop  for  initializing  Path  QoS  and  flows 

ref reshPathQoS (this) ; 

}  //  End  Path ( )  constructor  for  appending  new  node  to  an  existing  path 
/  *  * 

*  Constructs  a  new  path  by  means  of  concatenating  two  existing  paths. 

*  @param  sourceLeg  the  source  section  path.  Terminated  at  an  interface  on  an 

*  interfaceces  to  a  subnet  common  to  both  paths. 

*  @param  type  destinationLeg  the  destination  path  section.  Contains  all 

*  interfaces  traversed  tp  get  to  the  destination  node,  beginning  at  the 

*  interface  on  the  common  sunnet. 

*  @param  baInterfacelD  the  IPv6  address  of  the  outbound  interface. 

*  @param  baNeighborInterfacelD  the  IPv6  address  of  the  neighbor  interface 

*  (inbound) . 

*  @param  iBandwidth  the  total  bandwidth  of  the  outbound  inteface. 

*/ 

public  Path  ( 

Path  SourceLeg, 

Path  DestinationLeg, 

IPv6Address  newInterfacelD, 

IPv6Address  neighborInterfacelD, 
int  iBandwidth) 

{ 

//  Create  new  path  ID 
short  newID  =  iNextPathID++; 
iPathID  =  new  Integer (newID) ; 

//  Extract  the  source  and  destination  path  API  indexes  to  provide  the 
//  cooresponding  indexes  to  create  the  new  PIBarray  index  for  the  new 
//  path  :  aPIIndex  objaPIIndex 

aPIIndex  Sourceindex  =  SourceLeg. getaPIIndex () ; 

Integer  SourceNode  =  Sourceindex . getSource () ; 

aPIIndex  Destinationindex  =  DestinationLeg. getaPIIndex () ; 

Integer  DestinationNode  =  Destinationindex . getDestination ()  ; 

//  Generate  hop  count  from  the  sum  of  the  hop  counts  of  the  path  pair  and 
//  add  1  to  account  for  the  addition  of  the  link  joining  the  two  paths 
int  HopCount  = 

Sourceindex . getHopCount ( )  +  Destinationindex . getHopCount ( )  +  1; 

//  Create  the  actual  aPI  index 

objaPIIndex  =  new  aPIIndex (  SourceNode,  DestinationNode,  HopCount); 

//  [GX]  Can  we  concatenate  two  vectors  in  a  more  efficient  fashion? 
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//  Create  new  node  sequence  vector  by  concatenating  the  two  node  sequences 

//  Stores  the  sequence  of  nodes  for  this  path 
vNodeSequence  =  new  Vector  (); 

Enumeration  vDestinationNodeSequence  = 

DestinationLeg. getNode Sequence ( ) .elements ( ) ; 
while  ( VDestinationNodeSequence . hasMoreElements () ) 

{ 

vNodeSequence . addElement (vDestinationNodeSequence . nextElement ( ) ) ; 

} 


Enumeration  vSourceNodeSequence  =  SourceLeg . getNodeSequence (). elements () ; 
while  ( vSourceNodeSequence . hasMoreElements ( ) ) 

{ 

vNodeSequence . addElement (vSourceNodeSequence . nextElement ( ) ) ; 

} 

//  Assign  to  the  new  interface  sequence  the  interface  squence  of  dest.  leg 
vInterfaceSequence  =  DestinationLeg.getInterfaceSequenceO; 

Vinter face Sequence . addElement (newInterfacelD) ; 

Enumeration  srcLegInterf aces  =  SourceLeg. getInterfaceSequence (). elements ( ) 
while ( srcLegInterf aces . hasMoreElements () ) 

{ 

vInterfaceSequence . add ( srcLegInterf aces . nextElement ( ) ) ; 

} 


//  Creates  new  QoS  array  for  the  path's  service  levels  and  create  flow 
//  hashtables 

for  (int  si  =  0;  si  <  NUM_OF_SERVICE_LEVELS  -  1;  sl++) 

{ 

ob j PathQoS [ si ]  =  new  PathQoSO;  //  Initalize  Qos  for  each  service  level 
ahtFlows[sl]  =  new  Hashtable  (  );  //  Hashtable  of  flowIDs 


ref reshPathQoS (this)  ; 

}  //  End  path  constructor;  concatenate  two  existing  multi-hop  paths 


/  *  * 

*  Constructs  a  new  path  from  a  given  path,  traversing  the  same  nodes,  but  in 

*  oposite  direction. 

*  @param  originalPath  the  path  to  be  mirrored 
*/ 

public  Path  (Path  originalPath) 

{ 

//  Create  new  path  ID 
short  newID  =  iNextPathID++; 
iPathID  =  new  Integer (newID) ; 

//  Create  new  index  to  PIBarray  by  reversing  source  and  destinations 
aPIIndex  originalPathIndex  =  originalPath. getaPIIndex () ; 

Integer  newSource  =  originalPathIndex . getDestination ()  ; 

Integer  newDestination  =  originalPathIndex . getSource () ; 
int  numberHops  =  originalPathIndex . getHopCount () ; 

objaPIIndex  =  new  aPIIndex (  newSource,  newDestination,  numberHops  ); 

//  Generate  node  sequence  for  mirror  path  from  original  path 
Vector  vOriginalNodeSeq  =  (Vector ) originalPath . getNodeSequence () ; 
vNodeSequence  =  new  Vector  (); 

for  (int  index  =  vOriginalNodeSeq. size ( )  -  1;  index  >=  0;  index--) 

{ 

vNodeSequence . add ( (Integer)  vOriginalNodeSeq . elementAt ( index) ) ; 

}  //  End  reversed  sequence  of  nodes  traversed  by  original  path 

//  Get  the  original  interface  sequence 
vInterfaceSequence  =  new  Vector  (); 

Vector  vOriginallFaceSeq  = 

(Vector) originalPath . getInterfaceSequence ( ) ; 
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//  Traverse  the  nodes  of  the  new  sequence  and  discover  which  interfaces 

//  (outbound)  must  now  be  included  in  the  new  inversed/paired 

//  interface  sequence.  Add  them  to  the  new  vector 

for  (int  index  =  1;  index  <=  vNodeSequence . size  ( )  -  1;  index++) 

{ 

//  Get  the  inbound  (neighboring)  interface  from  the  original  sequence 
IPvGAddress  neighborlFace  = 

(IPv6Address)  vOriginallFaceSeq.elementAt ( 
vOriginallFaceSeq. size ( )  -  index); 

//  Get  the  subnet  mask  of  the  link 
byte  subnetMaskLength  =  ( ( Interfaceinfo) 

ht Interfaces . get (neighborlFace . toString ( ) ) ) . getSubnetMask ( ) ; 

//  Get  the  set  of  interfaces  for  determining  outbound  interface 
//  First  get  current  nodelD 

Integer  nodelD  =  (Integer)  vNodeSequence . elementAt (index) ; 

//  Need  to  transform  nodelD  into  IPvGAddress  based  RouterlD 
IPvGAddress  routerlD  =  (IPvGAddress)  htNodelDtoRouterlD. get (nodelD) ; 

//  Get  the  vector  of  all  interfaces  hosted  by  this  RouterlD 
Hashtable  iFaces  = 

(Hashtable)  htRouterInterfaceMap . get (routerlD. toString ( ) )  ; 

//  Now  search  for  the  matching  outbound  interface 
Enumeration  e  =  iFaces . elements () ; 

IPvGAddress  outboundIFace  =  null; 

while  (e .hasMoreElements ( ) ) 

{ 

IPvGAddress  check  =  (IPvGAddress)  e . nextElement ( ) ; 

if  ( Interface . isOnSameNetwork ( check,  neighborlFace,  subnetMaskLength)) 

{ 

outboundIFace  =  check; 
break; 

} 

} 


//  Add  this  outbound  interface  to  the  interface  sequence  of  mirrored  path 
vInterfaceSequence . add (outboundIFace) ; 

}  //  End  of  the  loop  to  invert  and  mirror  the  original  interface  sequence 

//  Copy  the  original  path's  quality  of  service  parameters 
for  (int  si  =  0;  si  <  NUM_OF_SERVICE_LEVELS  -  1;  sl++) 

{ 

ob j PathQoS [ si ]  =  new  PathQoSO;  //  Initalize  QoS  for  each  service  level 

ahtFlows[sl]  =  new  Hashtable (  ); 

}  //  End  for-loop  for  initializing  Path  QoS  and  flows 

//  Update  pertinent  tables 

//  Add  mirror  path  to  the  htPaths  hashtable 
ht Paths .put (iPathID,  this) ; 

//  Add  mirror  pathID  to  aPI  entry 
aPI  [newSource . intValue ( ) ] 

[newDestination . intValue ( ) ] 

[numberHops] .put (iPathID,  iPathID) ; 

//  Add  the  pathID  to  each  traversed  interface's  hashtable  of  pathIDs 
Enumeration  enuminterf acesTraversed  = 
this . get Interface Sequence ( ) .elements ( ) ; 
while  (enumInterfacesTraversed. hasMoreElements () ) 

{ 

IPvGAddress  InterfaceAddress  = 

( IPvGAddress )  enumInterfacesTraversed . nextElement ( ) ; 
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Interfaceinfo  InfoObject 

=  (Interfaceinfo)  ht Inter faces . get ( Inter faceAddr ess . toString ( ) ) ; 
Hashtable  PathTable  =  (Hashtable)  InfoObject . getPathIDs () ; 

PathTable .put (iPathID,  iPathID) ; 

}  //  End  of  loop  to  update  mirror  path's  interface  hashtables 
ref reshPathQoS (this) ; 

}  //  End  path  constructor  for  return  path  for  an  existing  path  (mirror  image) 
/  *  * 

*  Gets  the  path  ID 

*  Sreturn  the  path  ID  integer  wrapped  as  an  Integer  object 
*/ 

public  Integer  getPathIDO 

{ 

return  iPathID; 

} 


/  *  * 

*  Gets  the  reference  of  this  path  in  the  array  of  path  information  objects. 

*  @return  the  reference  to  the  array  of  path  information  objects. 

*/ 

public  aPIIndex  getaPIIndex ( ) 

{ 

return  objaPIIndex; 

} 

/  *  * 

*  Gets  the  array  of  path  QoS  objects  associated  with  each  service  level. 

*  @return  the  array  of  PathQoS  objects. 

*/ 

public  PathQoS  []  getPathQoSArray ( ) 

{ 

return  obj PathQoS; 

} 


/  *  * 

*  Gets  the  QoS  object  of  a  given  service  leve. 

*  @param  bServiceLevel  the  given  service  level. 

*  @return  the  PathQoS  object  of  the  specified  service  level. 
*/ 

public  PathQoS  getPathServiceLevelQoS (byte  bServiceLevel) 

{ 

return  objPathQoS [bServiceLevel] ; 

} 


/  *  * 

*  Gets  the  vector  with  the  node  sequence  the  path  traverses.  Nodes  are 

*  listed  from  destination  node  to  source  node. 

*  @return  the  Vector  with  the  node  sequence. 

*/ 

public  Vector  getNodeSequence ( ) 

{ 

return  vNodeSequence ; 

} 


y  *  * 

*  Gets  the  vector  with  the  sequence  of  interfaces  the  path  traverses.  The 

*  list  contain  only  outbound  interfaces,  from  destination  to  source. 

*  @return  a  Vector  with  all  the  interface  sequence 
*/ 

public  Vector  getInterfaceSequence ( ) 

{ 

return  vinterf aceSequence ; 

} 


y  *  * 
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*  Gets  the  next  available  flow  ID  for  this  path. 

*  @return  the  next  flow  ID. 

*/ 

public  int  getNewFlowID ( ) 

{ 

if  (++iNewFlowID  >  MAX_FLOW_ID) 

{ 

iNewFlowID  =  MIN_FLOW_ID; 

} 

return  iNewFlowID; 


/  *  * 

*  Gets  an  hashtable  with  all  flow  ID's  currently  associated  with  this  path, 

*  for  the  given  service  level. 

*  @param  iServiceLevel  the  given  service  level. 

*  @return  an  hashtable  with  all  flow  ID's  of  the  given  service  level. 

*/ 

public  Hashtable  getFlowIDs  (int  iServiceLevel) 

{ 

return  ahtFlows [ iServiceLevel ] ; 

} 


/  *  * 

*  Adds  a  new  flow  to  the  path,  in  a  given  service  level. 

*  @param  iServiceLevel  the  given  service  level. 

*  @param  iNewFLowLabel  the  flow  label  of  this  flow 

*  @return  void 
*/ 

public  void  AddFlow  (byte  iServiceLevel,  int  iNewFlowLabel) 

{ 

ahtFlows [iServiceLevel] .put ( 

new  Integer ( iNewFlowLabel ) ,  new  Integer (iNewFlowLabel) ) ; 

} 

y  *  * 

*  Adds  a  new  flow  to  the  path,  for  a  given  service  level. 

*  @param  iServiceLevel  the  given  service  level. 

*  @param  iNewFLowLabel  the  flow  label  of  this  flow 

*  @param  flowQoS  the  FlowQoS  characteristic  of  the  given  flow 

*  @return  void 
*/ 

public  void  AddFlow  (byte  iServiceLevel,  int  iNewFlowLabel,  FlowQoS  flowQoS) 

{ 

ahtFlows [iServiceLevel] .put (new  Integer (iNewFlowLabel) ,  flowQoS) ; 

} 


/  *  * 

*  Removes  a  given  flow  from  the  path. 

*  @param  iServiceLevel  the  service  level  to  which  the  flow  belongs 

*  @param  iFlowLabel  the  label  of  the  flow  to  be  removed 

*  @return  void 
*/ 

public  void  RemoveFlow  (byte  iServiceLevel,  Integer  iFlowLabel) 

{ 

ahtFlows [iServiceLevel ] . remove (iFlowLabel ) ; 

} 


y  *  * 

*  Deletes  all  flows  associated  with  a  path,  in  a  given  service  level. 

*  @param  iServiceLevel  the  given  service  level 

*  @return  void 
*/ 

public  void  DeleteAllFlows  (int  iServiceLevel) 

{ 

ahtFlows [iServiceLevel ] . clear (  )  ; 

} 

/  *  * 

*  Returns  a  String  with  the  path  ID  and  the  sequence  of  node  ID  the  path 

*  traverses 
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*/ 

public  String  toStringO 

{ 

String  str; 

//  Add  path  ID 

str  =  this . getPathID ( ) . toString ( )  +  "\t"; 

//  Step  through  each  node  the  path  traverses 
Enumeration  eNodeSeq  =  this . getNodeSequence (). elements () ; 

str  +=  (  ( Integer ) eNodeSeq. nextElement ( )  ). toString () ; 
while (eNodeSeq. hasMoreElements () ) 

{ 

//  Append  arrow  separator 
str  +=  "  <  "  + 

( (Integer) eNodeSeq. nextElement ( ) ) . toString ( ) ; 

} 


return  str; 

}  //  End  of  toString 0 
}  //  End  of  Path  class 


y  *  * 

*  The  PathQoS  class  represents  the  key  parameters  values  for  a  path's 

*  Quality  of  Service  for  a  given  service  level. 

*/ 

private  class  PathQoS 

{ 

/  *  * 

*  Minimum  available  bandwidth  among  all  interfaces  transversed  by  path 

*  (outbound  interfaces  only) .  The  available  bandwidth  being  considered 

*  is  the  bandwidth  not  being  used  by  a  service  level  out  of  the  initial 

*  base  allocation  (all  service  levels)  plus  the  interface  total  unallocated 

*  bandwidth  (only  for  service  levels  that  may  grow  dynamically:  IntServ 

*  and  DiffServ) . 

*/ 

int  pathAvBW; 
y  *  * 

*  Minimum  available  bandwidth  among  all  interfaces  transversed  by  path, 

*  inluding  inter-service  borrowing.  The  bandwidth  being  considered  is  the 

*  summation  of  the  pathAvBW  plus  any  bandwidth  that  may  be  made  available 

*  throug  inter-service  borrowing  (only  IntServ  and  DiffServ) . 

*/ 

int  pathAvBWwBorrowing; 

/  *  * 

*  Sum  of  the  delays  of  all  hops  taken  by  path (2  bytes) 

*/ 

short  pathDelay; 

/  *  * 

*  Sum  of  the  loss  rates  of  all  hops  taken  by  path (2  bytes) 

*/ 

short  pathLossRate; 
y  *  * 

*  Constructs  the  default  PathQoS  object. 

*/ 

public  PathQoS  (  ) 

{ 

pathAvBW  =  0 ; 
pathDelay  =  0; 
pathLossRate  =  0; 

} 

/  *  * 
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*  Updates  the  path  delay  given  a  differential  delay  value. 

*  @param  delayDelta  the  delay  variation  to  be  introduced. 

*  @return  void. 

*/ 

public  void  updatePathDelay  (short  delayDelta) 

{ 

pathDelay  +=  delayDelta; 

} 


/  *  * 

*  Updates  the  path  delay  given  a  differential  loss  rate  value. 

*  @param  lossRateDelta  the  loss  rate  variation  to  be  introduced 

*  @return  void 
*/ 

public  void  updatePathLossRate  (short  lossRateDelta) 

{ 

pathLossRate  +=  lossRateDelta; 

} 

y  *  * 

*  Sets  a  new  value  for  path  available  bandwidth. 

*  @param  iBandwidth  the  new  bandwidth  value. 

*  @return  void 
*/ 

public  void  setAvailableBandwidth  (int  iBandwidth) 

{ 

pathAvBW  =  iBandwidth; 

} 


//[PS]  created  to  provide  for  inter-service  borrowing 
/  *  * 

*  Sets  a  new  value  for  path  available  bandwidth  including  borrowing 

*  @param  int  the  new  value  for  the  available  bandwidth 

*  @return  void 
*/ 

public  void  setAvailableBandwidthIncludingBorrowing (int  iBandwidth) 

{ 

pathAvBWwBorrowing  =  iBandwidth; 

//Ensures  that  it  is  never  less  than  zero 
pathAvBWwBorrowing  = 

Math. max (0,  pathAvBWwBorrowing) ; 


y  *  * 

*  Gets  the  available  bandwidth. 

*  @return  the  available  bandwidth 
*/ 

public  int  getAvailableBandwidth ( ) 

{ 

return  pathAvBW; 

} 

//[PS]  created  to  provide  for  inter-service  borrowing 
/  *  * 

*  Gets  the  path  available  bandwidth  including  inter-service  borrowing. 

*  @return  the  available  bandwidth,  including  inter-service  borrowing. 
*/ 

public  int  getAvailableBandwidthIncludingBorrowing ( ) 

{ 

return  pathAvBWwBorrowing; 

} 

/  *  * 

*  Gets  path  delay. 

*  Sreturn  the  current  path  delay. 

*/ 

public  short  getPacketDelay ( ) 

{ 

return  pathDelay; 

} 
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y  *  * 

*  Gets  packet  loss  rate 

*  @return  the  current  value  of  loss  rate 
*/ 

public  short  getPacketLossRate ( ) 

{ 

return  pathLossRate ; 

} 

y  *  * 

*  Sets  a  new  value  for  the  path  delay. 

*  @param  newDelay  the  new  value  for  path  delay. 

*  Sreturn  void. 

*/ 

public  void  setDelay  (short  newDelay) 

{ 

pathDelay  =  newDelay; 

} 

/  *  * 

*  Sets  a  new  value  for  the  path  level  loss  rate. 

*  @param  newLossRate  the  new  value  for  the  path  loss  rate. 

*  @return  void. 

*/ 

public  void  setLossRate  (short  newLossRate) 

{ 

pathLossRate  =  newLossRate; 

} 

}  //  End  PathQoS  class 


y  *  * 

*  FlowQoS  Class  defines  objects  that  represent  the  key  QoS  characteristics  of 

*  a  flow  request. 

*/ 

private  class  FlowQoS 

{ 

/  *  * 

*  The  requested  delay  bound. 

*/ 

private  short  requestedDelay ; 
y  *  * 

*  The  requested  loss  rate  bound. 

*/ 

private  short  requestedLossRate ; 
y  *  * 

*  The  requested  bandwidth. 

*/ 

private  int  requestedBandwidth; 

/  *  * 

*  The  request  time  stamp  reference. 

*/ 

private  long  timeStamp; 

//[GX}  other  fields  such  as  typeOfApplication  may  be  added 
/  *  * 

*  Constructs  a  default  FlowQoS  object. 

*/ 

public  FlowQoS 0 

{ 

timestamp  =  0; 

requestedBandwidth  =  0; 
requestedDelay  =  0; 

requestedLossRate  =  0; 

}  //  End  of  FlowQoS  default  constructor 
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y  *  * 

*  Constructs  a  FlowQoS  with  a  given  timeStamp.  Used  by  BE  flows. 

*  @param  timeStamp  the  specified  time  stamp 
*/ 

public  FlowQoS (long  timeStamp) 

{ 

this . timeStamp  =  timeStamp; 

this . requestedBandwidth  =  Best_Ef fort_Allocated_Bandwidth; 
//[GX]  need  to  allow  variable  BW 


/  *  * 

*  Constructs  a  FlowQoS  with  the  given  initialization  values.  Used  by 

*  IntServ  and  DiffServ  flows. 

*  Sparam  timeStamp  the  given  time  stamp 

*  @param  requestedBandwidth  the  given  requested  bandwidth 

*  @param  requestedDelay  the  given  requested  delay 

*  @param  requestedLossRate  the  given  requested  loss  rate 
*/ 

public  FlowQoS ( 
long  timeStamp, 
int  requestedBandwidth, 
short  requestedDelay, 
short  requestedLossRate) 

{ 

this . timeStamp  =  timeStamp; 

this . requestedBandwidth  =  requestedBandwidth; 
this . requestedDelay  =  requestedDelay; 

this . requestedLossRate  =  requestedLossRate; 


/  *  * 

*  Sets  time  stamp  with  a  given  value. 

*  @param  time  the  new  time  stamp  value. 

*  @return  void. 

*/ 

public  void  setTimeStamp (long  time) 

{ 

timeStamp  =  time; 

} 


y  *  * 

*  Gets  the  time  stamp  value. 

*  @return  the  time  stamp  value. 

*/ 

public  long  getTimeStamp ( ) 

{ 

return  timeStamp; 

} 

y  *  * 

*  Sets  requestedBandwidth  with  a  given  value. 

*  @param  bandwidth  the  given  requested  bandwidth. 

*  @return  void. 

*/ 

public  void  setRequestedBandwidth (int  bandwidth) 

{ 

requestedBandwidth  =  bandwidth; 

} 


/  *  * 

*  Gets  the  requested  bandwidth  value. 

*  Sreturn  the  requested  bandwidth. 

*/ 

public  int  getRequestedBandwidth ( ) 

{ 

return  requestedBandwidth; 

} 


y  *  * 
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*  Sets  the  requested  delay  with  a  given  value 
*/ 

public  void  setRequestedDelay ( short  delay) 

{ 

requestedDelay  =  delay; 

} 

/  *  * 

*  Gets  the  requested  delay  value. 

*  @return  the  requested  delay. 

*/ 

public  short  getRequestedDelay ( ) 

{ 

return  requestedDelay; 

} 

/  *  * 

*  Sets  requested  loss  rate  with  a  given  loss  rate. 

*  @param  lossRate  the  given  loss  rate. 

*  @return  void. 

*/ 

public  void  setRequestedLossRate ( short  lossRate) 

{ 

requestedLossRate  =  lossRate; 

} 

y  *  * 

*  Gets  requested  loss  rate  value. 

*  @return  the  requested  loss  rate. 

*/ 

public  short  getRequestedLossRate (  ) 

{ 

return  requestedLossRate; 

} 


}  //  End  FlowQoS  class 
/  *  * 

*  The  ObsQoS  class  defines  an  object  responsible  for  storing  observed  QoS 

*  parameters  associated  with  a  given  pair  of  interfaceservice  -  service 

*  level. 

*/ 

private  class  ObsQoS 

{ 

y  *  * 

*  The  service  level  utilization  of  bandwidth,  as  measured  at  the  rounter 

*  interface.  Measured  in  percentage  and  affected  by  the  current  unit  of 

*  measure  (ServiceSA.UTIL_UNIT) . 

*/ 

private  short  iUtilization; 
y  *  * 

*  The  actual  packet  delay  accross  a  single  hop,  as  measured  and  reported 

*  by  a  router. 

*/ 

private  short  IDelay; 

/  *  * 

*  The  actual  packet  loss  rate  accross  a  single  hop  as  measures  and  reported 

*  by  a  rounter. 

*/ 

private  short  ILossRate; 

/  *  * 

*  Constructs  an  ObsQoS  object  with  default  initialization  parameters. 

*/ 

public  ObsQoS  (  ) 

{ 


iUtilization  =  0; 
IDelay  =  0; 
ILossRate  =  0; 
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} 


/  *  * 

*  Constructs  an  ObsQoS  objects,  initialized  with  the  given  parameters. 

*  @param  utilization  the  given  interface  utilization. 

*  @param  delay  the  link  delay. 

*  @param  lossRate  the  given  link  loss  rate 
*/ 

public  ObsQoS  (short  utilization,  short  delay,  short  lossRate) 

{ 

iUtilization  =  utilization; 
iDelay  =  delay; 

iLossRate  =  lossRate; 


/  *  * 

*  Sets  utilization  with  a  given  utilization. 

*  @param  obsUtil  the  given  utilization. 

*  @return  void 
*/ 

public  void  setUtilization  (short  obsUtil) 

{ 

iUtilization  =  obsUtil; 

} 


/  *  * 

*  Gets  the  utilization  value. 

*  @return  the  utilization  value. 
*/ 

public  short  getUtilization ( ) 

{ 

return  iUtilization; 

} 


/  *  * 

*  Sets  delay  with  a  given  delay  value. 

*  @param  obsDelay  the  given  delay  value. 

*  @param  void. 

*/ 

public  void  setDelay  (short  obsDelay) 

{ 

iDelay  =  obsDelay; 

} 

y  *  * 

*  Gets  the  delay  value. 

*  @return  the  delay  value. 

*/ 

public  short  getDelayO 

{ 

return  iDelay; 

} 

/  *  * 

*  Sets  the  loss  rate  with  a  given  loss  rate  value. 

*  @param  obsLossRate  the  given  new  loss  rate  value. 

*  @return  void. 

*/ 

public  void  setLossRate  (short  obsLossRate) 

{ 

ILossRate  =  obsLossRate; 

} 

/  *  * 

*  Gets  the  loss  rate  value. 

*  Sreturn  the  loss  rate  value. 

*/ 

public  short  getLossRate ( ) 

{ 

return  ILossRate; 

} 
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y  *  * 

*  Resets  the  QoS  array. 

*  @return  void 
*/ 

public  void  resetQoSO 

{ 

iDelay  =  0; 
iLossRate  =  0; 
iUtilization  =  0; 


}  //  End  of  ObsQoS  class 


/  *  * 

*  The  Interfaceinfo  class  defines  the  objects  that  contain  all  key 

*  information  associated  with  a  single  SAAM  interface. 

*/ 

private  class  Interfaceinfo 

{ 

/  *  * 

*  The  router  ID  is  an  wrapped  integer  that  uniquely  identifies  the  router 

*  hosting  the  interface. 

*/ 

private  Integer  iNodelD; 
y  *  * 

*  The  total  bandwidth  the  interface  supports. 

*/ 

private  int  iTotalBandwidth; 

/  *  * 

*  An  array  on  integers  that  represent  the  available  bandwidth  of  each 

*  service  level,  indexed  by  service  level  number.  The  available  bandwidth 

*  represents  the  amount  of  bandwidth  out  of  the  initial  base  allocation 

*  that  is  not  utilized  by  the  service.  Additionally  for  those  service 

*  levels  that  allow  for  dynamic  growing  (IntServ  and  DiffServ) ,  is  also 

*  includes  interface  bandwidth  that  is  currently  no  allocated  to  any 

*  service  (Unallocated  bandwidth) . 

*/ 

private  int[]  iServiceLevelAvailableBandwidth  = 
new  int [NUM_OF_SERVICE_LEVELS  -  1]; 

/  *  * 

*  An  array  on  integers  that  represent  the  bandwidth  capacity  that  the 

*  service  makes  available  for  inter-service  borrowing.  The  array  is  indexed 

*  by  service  level  numbers. 

*/ 

private  int[]  iServiceLevelBorrowingCapacity  = 
new  int [NUM_OF_SERVICE_LEVELS  -  1]; 

y  *  * 

*  The  interface  bandwidth  capacity  that  is  not  allocated/claimed  to  any  of 

*  the  service  levels. 

*/ 

private  int  iUnallocatedBandwidth; 

/  *  * 

*  The  number  of  bits  used  to  determine  the  interface's  network  ID  out  of 

*  the  interface  IPv6  address. 

*/ 

private  byte  bSubnetMask; 

/  *  * 

*  The  table  containing  all  path  IDs  that  traverse  this  interface  (outbound 

*  direction) . 

*/ 

private  Hashtable  htPathIDs; 
y  *  * 

*  The  array  of  ObsQoS  objects,  indexed  by  service  level.  Each  ObsQoS  objetc 
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*  describes  the  observed  QoS  characteristics  of  a  single  service  level 

*  accross  the  interface. 

*/ 

private  ObsQoS  aobjObsQoS[]  =  new  ObsQoS [NUM_OF_SERVICE_LEVELS  -  1]; 

/  *  * 

*  Constructs  an  Interfaceinfo  object  with  the  given  initialization 

*  parameters. 

*  @iNewID  the  given  interface  ID  number. 

*  @iBandwidth  the  given  interface  total  bandwidth. 

*  @param  bSubnetMask  the  given  number  of  bits  for  the  subnet  mask. 

*  @param  htIDs  the  hash  table  of  paths  that  traverse  this  interface. 

*/ 

public  Interfaceinfo  ( 

Integer  iNewID,  int  iBandwidth,  byte  bSubnetMask,  Hashtable  htIDs) 

{ 

float  allocationFactor  =  O.Of; 
setNodelD  (iNewID) ; 
setTotalBandwidth  (iBandwidth) ; 

for  (int  si  =  0;  si  <  NUM_OF_SERVICE_LEVELS  -  1;  sl++) 

{ 

iServiceLevelAvailableBandwidth [si]  = 

(int)  (iBandwidth  *  afBASE_ALLOCATION [ si ]  *  af L0AD_FACT0R [ si ] ) ; 
allocationFactor  +=  afBASE_ALLOCATION [si] ; 
iServiceLevelBorrowingCapacity [ si ]  =  0; 

aobjObsQoS [si]  =  new  ObsQoS ( (byte )  0,  (short)  0,  (short)  0); 

} 

setUnallocatedBandwidth (iBandwidth  - 

(int) ( (float) iBandwidth  *  allocationFactor)); 
setSubnetMask  (bSubnetMask) ; 
setPathIDs  (htIDs) ; 

ref reshInterfaceQoS (this)  ; 

}  //  End  of  constructor ( ) 

/  *  * 

*  Sets  the  node  ID  with  a  given  value. 

*  @param  iNewID  the  given  value  for  node  ID. 

*  @return  void. 

*/ 

public  void  setNodelD  (Integer  iNewID)  { 
iNodelD  =  iNewID; 

} 


/  *  * 

*  Gets  the  node  ID. 

*  @return  the  node  ID. 

*/ 

public  Integer  getNodeID(  ) 

{ 

return  iNodelD; 

} 


/  *  * 

*  Sets  the  interface  total  bandwidth  with  a  given  value. 

*  @param  iBW  the  new  given  bandwidth  value. 

*  @return  void. 

*/ 

public  void  setTotalBandwidth  (int  iBW) 

{ 

iTotalBandwidth  =  iBW; 

} 


/  *  * 

*  Gets  the  bandwidth  of  the  interface. 

*  @return  the  bandwidth  to  the  interface. 
*/ 

public  int  getTotalBandwidth (  ) 
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{ 

return  iTotalBandwidth; 

} 


/  *  * 

*  Sets  the  available  bandwidth  of  given  service  level  with  a  new  value. 

*  @param  iBandwidth  the  new  bandiwdth. 

*  @param  bSL  the  service  level. 

*  @return  void. 

*/ 

public  void  setServiceLevelAvailableBandwidth  (int  iBandwidth,  byte  bSL  ) 

{ 

iServiceLevelAvailableBandwidth [bSL]  =  iBandwidth; 

} 


// [PS] 

/  *  * 

*  Sets  a  new  value  for  the  unallocated  bandwidth. 

*  @param  iNewBWValue  the  new  unallocated  bandwidth  value 

*  @return  void 
*/ 

public  void  setUnallocatedBandwidth ( int  iNewBWValue) 

{ 

iUnallocatedBandwidth  =  iNewBWValue; 

} 

//[PS]  -  created  to  support  inter-service  borrowing 
/  *  * 

*  Sets  the  borrowing  capacity  for  a  given  service  level. 

*  @param  borrowingCapacity  integer  w/  the  bandwidth  available  for  borrowing 

*  @param  serviceLevel  the  service  level  the  bandwidth  refers  to 

*  @return  void 
*/ 

public  void  setServiceLevelBorrowingCapacity (int  iBCapacity,  byte  bSL  ) 

{ 

iServiceLevelBorrowingCapacity [bSL]  =  iBCapacity; 

} 

/  *  * 

*  Gets  the  current  value  of  available  bandwidth,  for  the  specified 

*  service  level. 

*  @param  svcLevel  the  servicel  level. 

*  @return  an  integer  with  the  amount  of  available  bandwidth 
*/ 

public  int  getServiceLevelAvailableBandwidth (byte  bSL) 

{ 

return  iServiceLevelAvailableBandwidth [bSL] ; 

} 


//[PS]  -  required  to  enable  inter-service  borrowing 
/  *  * 

*  Retrives  the  borrowing  capacity  for  the  required  service  level 

*  @param  iSL  the  required  service  level 

*  @return  an  integer  with  the  required  value  of  borrowing  capacity 
*/ 

public  int  getServiceLevelBorrowingCapacity (byte  bSL) 

{ 

return  iServiceLevelBorrowingCapacity [bSL] ; 

} 


//[PS]  -  required  to  enable  inter-service  borrowing 
/  *  * 

*  Retrives  the  current  value  of  unallocated  bandwidth 

*  Sreturn  an  integer  with  the  current  value  of  unallocated  bandwidth 
*/ 

public  int  getUnallocatedBandwidth ( ) 

( 

return  IUnallocatedBandwidth; 

} 

/  *  * 
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*  Sets  the  subnet  mask  number  with  a  given  value. 

*  @param  bSMask  the  given  new  value  for  the  subnet  mask. 

*  @return  void. 

*/ 

public  void  setSubnetMask  (byte  bSMask) 

{ 

bSubnetMask  =  bSMask; 

} 


/  *  * 

*  Gets  the  subnet  mask  value. 

*  Sreturn  the  value  of  the  subnet  mask. 

*/ 

public  byte  getSubnetMask (  ) 

{ 

return  bSubnetMask; 

} 

/  *  * 

*  Sets  the  table  of  path  IDs  with  a  given  table. 

*  @param  htIDs  the  given  table  of  path  IDs. 

*  @return  void. 

*/ 

public  void  setPathIDs  (Hashtable  htIDs) 

{ 

htPathIDs  =  htIDs; 

} 


/  *  * 

*  Gets  the  table  of  path  IDs. 

*  @return  the  table  of  path  IDs. 
*/ 

public  Hashtable  getPathIDs (  ) 

{ 

return  htPathIDs; 

} 


/  *  * 

*  Sets  the  obsQoS  of  a  specified  service  level  with  a  given  value. 

*  Sparam  obsQoS  the  new  obsQoS  value. 

*  @param  bSL  the  specified  service  level. 

*  @return  void. 

*/ 

public  void  setQoS  (ObsQoS  obsQoS,  byte  bSL) 

{ 

aobjObsQoS [bSL]  =  obsQoS; 

} 


/  *  * 

*  Gets  the  array  of  obsQoS  objects  for  all  service  levels. 

*  @return  the  array  of  obsQoS  objects  for  all  service  levels. 
*/ 

public  ObsQoS []  getQoS (  ) 

{ 

return  aobj ObsQoS; 

} 


/  *  * 

*  Resets  the  interface  QoS  array. 

*  @return  void. 

*/ 

public  void  resetQoSO 

{ 

testMsg ( "Inter face Info . resetQoS ( ) " ) ; 
float  allocationFactor  =  O.Of; 

for  (int  si  =  0;  si  <  NUM_OF_SERVICE_LEVELS  -  1;  sl++) 

{ 

IServiceLevelAvailableBandwidth [si]  = 

(int)  (ITotalBandwidth  *  afBASE_ALLOCATION [ si ]  *  af LOAD_FACTOR [ si ] ) 
allocationFactor  +=  afBASE_ALLOCATION [si] ; 
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iServiceLevelBorrowingCapacity [ si ]  =  0; 
aobjObsQoS [si] . resetQoS ( ) ; 


setUnallocatedBandwldth (ITotalBandwldth  - 

(Int) ( (float) ITotalBandwldth  *  allocatlonFactor) ) ; 

ref reshInterfaceQoS (this) ; 

}//end  of  resetQoS 0 

}  //  End  of  Interfaceinfo  class 

/  *  * 

*  RoutingAlgorithm  class  implements  a  set  of  routing  algorithms  required  to 

*  find  paths  in  the  PIB  structure,  meeting  a  set  of  given  requirements. 

*/ 

private  class  RoutingAlgorithm 

{ 

y  *  * 

*  For  the  selection  of  the  First-Shortest  Path  algorithm. 

*/ 

public  static  final  byte  FIRST_SHORTEST_PATH  =  1; 

/  *  * 

*  For  the  selection  of  the  Shortest-Widest  Path  algorithm. 

*/ 

public  static  final  byte  WIDEST_SHORTEST_PATH  =  2; 

/  *  * 

*  For  the  selection  of  the  Shortest  Widest  Path  algorithm. 

*/ 

public  static  final  byte  SHORTEST_WIDEST_PATH  =  3; 

/  *  * 

*  Default  constructor.  The  RoutingAlgorithm  class  is  a  stateless 

*  class,  and  so  there  exist  only  a  default  empty  constructor. 

*/ 

public  RoutingAlgorithm)) 

{ 

//  Empty  default  constructor 

} 


/  *  * 

*  Implementation  of  the  First  Shortest  Path  algorithm  for  Best  Effort. 

*  The  admission  procedure  for  BE  requires  revion.  Currently,  a  BE  flow  is 

*  admited  if  there  is  more  than  50k  of  path  available  BW  in  the  BE  svc  level. 

*  @param  srcRterlD  the  IPv6  address  of  the  source  router. 

*  @param  destRterlD  the  IPv6  address  of  the  destination  router. 

*  @return  the  required  path  or  null  if  no  path  was  found. 

*/ 

private  Path  f indPathFSP ( IPv6Address  srcRterlD,  IPv6Address  destRterlD) 

{ 

testMsg ( "f indPathFSP ( )  for  Best  Effort"); 

Interfaceinfo  interfaceinformation  = 

(Interfaceinfo)  ht Interfaces . get (srcRterlD. toString ( ) ) ; 

int  sourceNodelD  =  ((Interfaceinfo)  htinterfaces . 
get (srcRterlD. toString ( ) ) ) . getNodelD ( ) . intValue ( ) ; 

int  destinationNodelD  =  ((Interfaceinfo)  htinterfaces. 
get (destRterlD. toString ( ) ) ) . getNodelD ( ) . intValue ( ) ; 

Path  bestPath  =  null; 

Hashtable  table  =  new  HashtableO; 

//labeled  compound  statement 
stop : 

{ 
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for  (int  1=1;  1  <  MAX_HOP_COUNT;  1++  ) 

{ 

testMsgC'Hop  count  =  "  +  1)  ; 

table  =  aPI [sourceNodelD]  [destlnatlonNodelD]  [1]  ; 

Enumeration  enum  =  table . elements () ; 

If  (enum.hasMoreElements ( ) ) 

{ 

//Cycle  through  each  of  the  paths  of  the  current  hop  count,  between 
//source  and  destination  nodes 
while  (enum.hasMoreElements 0 ) 

{ 

Integer  currentPathID  =  (Integer)  enum. nextElement ( ) ; 

//  Extract  current  path  Information 
bestPath  =  (Path)  htPaths . get (currentPathID) ; 

Int  avallableBandwldth  = 

bestPath . getPathServlceLevelQoS (BEST_EFFORT) . 
getAvallableBandwldth ( ) ; 


// 

//  If  available  BW  Is  greater  than  50k  the  flow  Is  admlted 
//  This  Is  a  magic  number 
If  (avallableBandwldth  >=  50000) 

{ 


display. sendText ( 

"\t  The  selected  path  ls:\t"  +  bestPath . toStrlng ( )  +  "\n"  + 

"\t  Available  bandwidth;  \t"  +  avallableBandwldth); 

break  stop; 

}//End  of  If  structure 
}//End  of  while-loop 
}//End  of  If  structure 
}//End  of  for-loop 
}//End  of  labeled  stop  structure 
return  bestPath; 

}//End  of  flndPathO  for  Best  Effort  Service 
/  *  * 

*  Searches  the  PIB  path  structure  for  a  path  between  given  source  and 

*  destination  routers. 

*  Different  routing  algorihtms  may  be  used  depending  on  user  option. 

*  Currently,  only  First-Widest  Path  algorithm  (FSP)  is  implemented. 

*  @param  sourceRouterlD  the  IPv6  address  of  the  source  router. 

*  @param  destinationRouterlD  the  IPv6  address  of  the  destination  router. 

*  @param  rotingAlgorithm  the  routing  algorithm  to  be  used. 

*  @return  the  Path  object  of  a  suitable  path  or  null  if  otherwise. 

*/ 

protected  Path  findPath ( 

IPv6Address  sourceRouterlD, 

IPv6Address  destinationRouterlD, 
byte  routingAlgorithm) 

{ 

Path  resultPath  =  null; 

switch (routingAlgorithm) 

{ 

case  FIRST_SHORTEST_PATH: 

resultPath  =  findPathFSP (sourceRouterlD,  destinationRouterlD); 
break; 

case  SHORTEST_WIDEST_PATH; 
display. sendText ( 
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" \tShortest-Widest  Path  routing  algorithm  not  implemented"); 
break; 

case  WIDEST_SHORTEST_PATH; 
display. sendText ( 

" \tWidest-Shortest  Path  routing  algorithm  not  implemented"); 
break; 

default : 

display . sendText ( "\t\tlnvalid  type  of  routing  algorithm"); 

} 

return  resultPath; 

}  //  end  of  findPathO 


/  *  * 

*  Searches  the  PIB  path  structure  for  a  path  that  fulfills  the  specified 

*  QoS  requirements.  If  interservice  borrowing  is  enabled,  a  path  using 

*  interservice  borrowing  will  only  be  selected  if  no  paths  exists  ( 

*  (any  hop  count)  considering  no  interservice  borrowing  bandwidth. 

*  Different  routing  algorihtms  may  be  used  depending  on  user  option. 

*  Currently,  only  First-Widest  Path  algorithm  (FSP)  is  implemented. 

*  @param  sourceRouterlD  the  IPv6  address  of  the  source  router. 

*  @param  destinationRouterlD  the  IPv6  address  of  the  destination  router. 

*  @param  requestedBandwidth  the  requested  bandwidth. 

*  @param  requestedDelay  the  requested  upper  bound  on  end-to-end  delays. 

*  @param  requestedLossRate  requested  upper  bound  on  end-to-end  loss  rate. 

*  @param  bSL  the  service  level  (INT_SERV  or  DIFF_SERV) . 

*  @param  isBorrowingAllowed  whether  inter-service  borrowing  is  allowed. 

*  Sparam  rotingAlgorithm  the  routing  algorithm  to  be  used. 

*  Sreturn  the  Path  object  of  a  suitable  path  or  null  if  otherwise. 

*/ 

protected  Path  findPath ( 

IPv6Address  sourceRouterlD, 

IPv6Address  destinationRouterlD, 
int  requestedBandwidth, 
short  requestedDelay, 
short  requestedLossRate, 
byte  bSL, 

boolean  isBorrowingAllowed, 
byte  routingAlgorithm) 

{ 

Path  resultPath  =  null; 

switch (routingAlgorithm) 

{ 

case  FIRST_SHORTEST_PATH; 
resultPath  =  findPathFSP ( 

sourceRouterlD, 

destinationRouterlD, 

requestedBandwidth, 

requestedDelay, 

requestedLossRate, 

bSL, 

isBorrowingAllowed) ; 

break; 

case  SHORTEST_WIDEST_PATH; 
display. sendText ( 

" \tShortest-Widest  Path  routing  algorithm  not  implemented"); 
break; 

case  WIDEST_SHORTEST_PATH; 
display. sendText  ( 

" \tWidest-Shortest  Path  routing  algorithm  not  implemented"); 
break; 

default : 

display . sendText ( "\t\tlnvalid  type  of  routing  algorithm"); 

} 

return  resultPath; 

}  //  end  of  findPath 0 
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y  *  * 

*  Implementation  of  the  First  Shortest  Path  with  inter-service  borrowing 

*  capability.  Searches  the  PIB  for  a  path  that  can  provide  the  required  QoS 

*  guarantees.  Shortest  path  are  first  evaluated  and  the  first  meeting  the 

*  QoS  requirements  is  selected.  If  interservice  borrowing  is  enabled, 

*  a  path  using  interservice  borrowing  will  only  be  selected  if  no  paths 

*  exists  (any  hop  count)  considering  no  interservice  borrowing  bandwidth. 

*  This  implementation  is  therefore  the  shortest  in  time  and  the  most 

*  efficient  search  algorithm. 

*  @param  sourceRouterlD  the  IPv6  address  of  the  source  router. 

*  @param  destinationRouterlD  the  IPv6  address  of  the  destination  router. 

*  @param  requestedBandwidth  the  requested  bandwidth. 

*  @param  requestedDelay  the  requested  upper  bound  on  end-to-end  delays. 

*  @param  requestedLossRate  requested  upper  bound  on  end-to-end  loss  rate. 

*  @param  bSL  the  service  level  (INT_SERV  or  DIFF_SERV) . 

*  @param  isBorrowingAllowed  whether  inter-service  borrowing  is  allowed. 

*  @return  the  Path  object  of  a  suitable  path  or  null  if  otherwise. 

*/ 

private  Path  findPathFSP ( 

IPv6Address  sourceRouterlD, 

IPv6Address  destinationRouterlD, 
int  requestedBandwidth, 
short  requestedDelay, 
short  requestedLossRate, 
byte  bSL, 

boolean  isBorrowingAllowed) 

{ 

testMsg ( "findPathFSP ( )  for  IntServS  or  DiffServ"); 

Path  foundPath  =  null; 

Path  f oundPathWithBorrowing  =  null; 

Path  tempPath  =  null; 

int  availableBW  =  0; 

int  availableBWIncludingBorrowing  =  0; 
short  delayBound  =  0; 
short  lossRateBound  =  0; 

Interfaceinfo  interfaceinformation  = 

( Inter face Info)  ht Inter faces . get (sourceRouterlD. toSt ring ( ) ) ; 

//Source  node 

int  sourceNodelD  =  ((Interfaceinfo) 

ht Inter faces . get (sourceRouterlD. toSt ring ( ) ) ) . getNodelD ( ) . intValue ( ) ; 

//Destination  node 

int  destinationNodelD  =  ((Interfaceinfo) 

ht Inter faces . get (destinationRouterlD. toSt ring ( ) ) ) . getNodelD ( ) . intValue ( ) 

//There  exists  at  least  a  physical  path,  so  let's  proceed 
Hashtable  table  =  new  HashtableO; 

testMsg ( "Destination  node  is  reachable  from  source  node"); 

//labeled  compound  statement 
stop : 

{ 


for  (int  i  =  1  ;  i  <  MAX_HOP_COUNT  ;  i++  ) 

{ 

testMsgC'Hop  count  =  "  +  i)  ; 

table  =  aPI [sourceNodelD]  [destinationNodelD]  [i]  ; 

Enumeration  enum  =  table . elements () ; 

if  (enum.hasMoreElements ( ) ) 

{ 

//Cycle  through  each  of  the  paths  of  the  current  hop  count,  between 
//source  and  destination  nodes 
while  (enum.hasMoreElements 0 ) 

( 
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Integer  currentPathID  =  (Integer)  enum. nextElement ( ) ; 

//  Extract  that  path  QoS  information 
tempPath  =  (Path)  htPaths , get ( currentPathID) ; 

/ /Bandwidth 
availableBW  = 

tempPath . getPathServiceLevelQoS (bSL) . getAvailableBandwidth ( ) ; 

//Bandwidth  including  inter-service  borrowing 
availableBWIncludingBorrowing  = 

tempPath . getPathServiceLevelQoS (bSL) 

. getAvailableBandwidthIncludingBorrowing ( ) ; 

//Delay  bound 

delayBound  =  tempPath . getPathServiceLevelQoS (bSL) . getPacketDelay ( ) 

//Loss  Rate  bound 
lossRateBound  = 

tempPath . getPathServiceLevelQoS (bSL) . getPacketLossRate () ; 

testMsg ( "Evaluating  path  "  +  currentPathID); 
testMsg ( " \tAvailable  BW:  \t"  +  availableBW); 

testMsg (" XtAvailable  BW-B:\t"  +  availableBWIncludingBorrowing); 
testMsg (" \tDelay :  \t"  +  availableBWIncludingBorrowing); 

testMsg ("\tLoss  Rate:  \t"  +  lossRateBound); 

//Check  if  current  path  fits  request  (no  inter-service  borrowing) 
if  ( 

delayBound  <=  requestedDelay  && 
lossRateBound  <=  requestedLossRate) 

{ 

//Current  path  meets  delay  and  loss  rate  QoS  demands 
//Now  check  for  bandwidth  with  no  borrowing 

testMsg ( "Meets  delay  and  loss  rate  QoS  demands"); 

if (availableBW  >=  requestedBandwidth) 

{ 

//Current  path  is  the  first  that  meets  the  QoS  demands 
//without  considering  borrowing.  Select  it  and  leave  path  loop 
testMsg ( "Meets  bandwidth  requirements"  + 

"  with  no  need  for  interservice  borrowing"); 
testMsg ("**  PATH  SELECTED  ***"); 
foundPath  =  tempPath; 
break  stop; 

} 


//  If  borrowing  is  allowed  and  a  path  with  borrowing  has  not  yet 
//  been  found,  check  if  current  path  meets  bandwidth 
//  requirements,  now  considering  inter-service  borrowing 
else  if ( 

isBorrowingAllowed  & 
f oundPathWithBorrowing  ==  null  && 

availableBWIncludingBorrowing  >=  requestedBandwidth) 

{ 

//Current  path  is  the  first  that  meets  the  QoS  requirements 
//having  considered  inter-service  borrowing.  Select  it  and 
//continue  searching  for  a  suitable  path  with  no  borrowing 
f oundPathWithBorrowing  =  tempPath; 

testMsg ( "Meets  bandwidth  requirements  "  + 

"only  if  interservice  borrowing  is  considered"); 
testMsg ( "Continue  searching  for  other  paths..."); 

} 

else 

{ 

testMsg ( "There  is  not  enough  available  bandwidth"); 

} 


}  //  End  of  if  structure  compare 
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testMsg ( "Done  evaluating  path."); 

}  //  End  of  while-loop  through  all  paths  of  same  hop-count 
testMsg("No  more  paths  of  hop  count  =  "  +  i) ; 

}  //  End  of  if  structure 
}  //  End  of  for-loop  for  increasing  hop-count 
testMsg ("\tAll  paths  from  source  to  destination  evaluated"); 

}  //  End  of  labeled  stop  structure 


//  Prepare  information  for  display 

String  borrowingStatus  =  ( isBorrowingAllowed)  ?  "enabled"  :  "disabled"; 
String  admissionCondition  = 

"There  was  no  need  for  inter-service  borrowing"; 

//  If  a  path  with  no  borrowing  could  not  be  found  and  borrowing  is  enabled 
//  return  result  will  either  be  a  path  with  borrowing  or  null 
if  (foundPath  ==  null  && 
isBorrowingAllowed  && 
f oundPathWithBorrowing  !=  null) 

{ 

foundPath  =  foundPathWithBorrowing; 
admissionCondition  = 

"Admission  possible  only  with  inter-service  borrowing"; 

} 

display . sendText ( "\tRouting  algorithm  results:"); 

if (foundPath  ==  null) 

{ 

//No  path  found  information 
display. sendText ( 

"\t  There  are  currently  no  paths  available  meeting  this  QoS  demand 

+  "\n\t  Inter-service  borrowing:  "  +  borrowingStatus) ; 

} 

else 

{ 

//Path  found  -  display  information 
display. sendText ( 


"\t 

The  selected  path  is: 

\t" 

+ 

foundPath . toString ( ) +"\n 

"\t 

Available  bandwidth: 

\t" 

+ 

availableBW  + 

"\n"  + 

"\t 

Packet  delay  upper-bound: 

\t" 

+ 

delayBound  + 

\n"  + 

"\t 

Packet  loss  rate  upper-bound 

\t" 

+ 

lossRateBound 

+  "\n"  + 

"\t 

Inter-service  borrowing: 

\t" 

+ 

borrowingStatus  +  "\n"  + 

"\t 

"  +  admissionCondition 

)  ; 

}  //  End  if 
return  foundPath; 

}  //End  of  findPathFSP 0 
}  //  End  if  RoutingALgorithm  class 

//  End  of  the  inner  classes  definition  - 

/  *  * 

*  Constructs  the  BasePIB  object  with  a  given  reference  to  a  SAAM  server. 

*  @param  theServer  the  Server. 

*/ 

public  BasePIB  (Server  theServer) 

{ 

//  Create  Gui  for  PIB  display  during  generation. 
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display  =  new  SAAMRouterGui ( "PathInformationBase" ) ; 
theServer . getControlExec (). addComponentGui (display) ;  //  -crcy 
myServer  =  theServer; 
vIFacesTraversed  =  new  Vector (); 

df  =  ( DecimalFormat ) NumberFormat . getCurrencyInstance ( ) ; 
df . setMaximumFractionDigits ( 2 ) ; 
df . applyPattern  ( "#0 . 00%" ) ; 

//  Launch  PIB  tester  if  in  Testing  Mode 
if (TESTING_MODE)  { 

pibTest  =  new  Thread (new  PibTester (this) ) ; 
pibTest . start ( ) ; 

} 


//  Instantiate  the  array  of  hashtables  to  hold  path  IDs  as  paths  are  created 
aPI  =  new  Hashtable  [MAX_NODE_NUMBER]  [MAX_NODE_NUMBER]  [MAX_HOP_COUNT ] ; 
for  (int  i  =  0;  i  <  MAX_NODE_NUMBER;  i++) 

{ 

for  (int  j  =0;  j  <  MAX_NODE_NUMBER;  j++) 

{ 

for  (int  k  =  0;  k  <  MAX_HOP_COUNT;  k++) 

{ 

//  Instantiate  hashtables  for  each  element  of  the  Path  Info  array 
aPI[i][j][k]  =  new  HashtableO; 


}  //  End  of  array  creation 

//  Instantiate  each  PIB  member  hashtable 
htRouterlDtoNodelD  =  new  HashtableO; 
htNodelDtoRouterlD  =  new  HashtableO; 
htRouter Interf aceMap  =  new  HashtableO; 
htinterfaces  =  new  HashtableO; 
htPaths  =  new  HashtableO; 

//  used  for  Differentiated  Service 
//[GX]:  carried  over  from  Henry's  code? 

//  only  six  user-ids  are  registered;  read  from  a  file? 
htUserSLSs  =  new  HashtableO; 

//  Put  six  entries  to  the  table 

htUserSLSs .put (new  Integer (1),  new  SLS (SLS . SILVER_CLASS) ) ; 
htUserSLSs .put (new  Integer (2),  new  SLS ( SLS . BRONZE_CLASS ) ) ; 
htUserSLSs .put (new  Integer (3),  new  SLS ( SLS . GOLD_CLASS ) ) ; 
htUserSLSs .put (new  Integer (4),  new  SLS (SLS . SILVER_CLASS) ) ; 
htUserSLSs .put (new  Integer (5),  new  SLS ( SLS . BRONZE_CLASS ) ) ; 
htUserSLSs .put (new  Integer (6),  new  SLS ( SLS . GOLD_CLASS ) ) ; 

//  Instantiate  the  routing  algorithm  object. 
routingAlgorithm  =  new  RoutingAlgorithm  ( ) ; 

//Display  pib  generic  information 
display. sendText (this . toSt ring ( ) ) ; 

//Set  default  state  for  interservice  borrowing 
setInterserviceBorrowing (INTERSERVICE_BORROWING_DEFAULT) ; 
setBorrowingThreshold (DEFAULT_BORROWING_THRESHOLD) ; 

}  //  End  BasePIB  constructor ( ) 

/  *  * 

*  Resets  the  PIB,  allowing  for  efficient  clearance  of  server  resources 

*  allocated  for  path  status  maintenance.  Wise  to  be  used  during 

*  initialization  of  a  SAAM  server. 

*  @return  void. 

*/ 

public  void  resetPIB (  ) 
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for  (int  i  =  0;  i  <  MAX_NODE_NUMBER;  i++) 

{ 

for  (int  j  =0;  j  <  MAX_NODE_NUMBER;  j++) 

{ 

for  (int  k  =  0;  k  <  MAX_H0P_C0UNT;  k++) 

{ 

//  Clear  the  hashtable  stored  in  the  array  element 
aPI  [i]  [ j ]  [k]  . clear  ( )  ; 

} 

} 


//  Clear  each  PIB  member  hashtable 
htRouterlDtoNodelD. clear  ( ) ; 
htNodelDtoRouterlD. clear ( ) ; 
htRouter Interf aceMap . clear  ( ) ; 
htinterfaces . clear ( ) ; 
htPaths . clear  ( ) ; 

}  //  End  of  resetPIBO 

/  *  * 

*  Returns  a  String  identifying  the  version  of  the  PIB. 

*  @return  the  String  identifying  the  current  PIB  version. 
*/ 

public  String  toStringO 

{ 

return  strPIB_VERSION; 

} 


/  *  * 

*  Returns  string  to  display  all  paths  of  the  PIB. 

*  @return  the  string  with  all  paths  of  the  PIB. 

*/ 

public  String  toStringPaths ( ) 

{ 

//  Option  for  displaying  only  path  id  and  nothe  sequence 
final  int  OPTION  =  1; 

return  toStringPaths (OPTION) ; 

}  //  End  og  displayPaths ( ) 


/  *  * 

*  Returns  a  string  with  all  paths  currently  in  the  PIB,  for  displaying 

*  purposes.  Several  options  for  display  are  available  through  the  argument 

*  provided,  so  that  different  detail  is  obtained. 

*  @param  option  the  available  display  option  (-1  to  2). 

*  @return  String  the  string  representation  of  the  paths. 

*/ 

public  String  toStringPaths ( int  option) 

{ 

String  disp  =  new  String)); 

disp  =  "\n*****  Paths  in  the  PIB  *****\n"; 
if (option  <  -1  I  I  option  >  2) 

{ 

option  =  -1; 

} 

if (option  ==  -1 ) 

{ 

disp  += 

"Following  display  options  are  available : \n"  + 

"  0  ;  Total  number  of  paths  in  the  PIB\n"  + 

"  1  ;  List  all  paths  and  interfaced  transversedXn"  + 

"  2  ;  List  all  paths,  interfaces  transversed  and  QoS  inf ormation\n 

"  n  :  Display  only  path  ID  'n'\n"  + 

"  -1  ;  Display  this  help  information  and  the  total  number  of  paths! 


int  nrPaths  =  htPaths . size  ( )  ; 


disp  +=  "\n\tTotal; 


+  nr Paths; 


if  (  ((option  ==  1)  II  (option  ==  2))  &&  nrPaths  >  0  ) 

{ 

//  Step  through  each  path  in  the  PIB 
Enumeration  enum  =  htPaths . elements () ; 
disp  +=  "\n\tPath-ID\tNode-sequence\n"; 

while  (enum.hasMoreElements ( ) ) 

{ 

//  Get  path 

Path  path  =  (Path) enum. nextElement () ; 

//  Display  path  ID  and  node  sequence 
disp  +=  "\t"  +  path . toString ( )  +  "\n"; 

if  (option  ==  2) 

{ 

//Option  tp  display  also  path  QoS  information 
PathQoS  pqos[]  =  path . getPathQoSArray ( ) ; 


disp  +=  "\n\t\tSL  XtAvailable  BW  \tAvailable  BW-B  \tDelay  \tLoss  Rate 
for  (int  i  =  0  ;  i  <  pqos. length  ;  i++) 

{ 


disp 

+  = 

"\n\t" 

disp 

+  = 

"\t" 

+ 

i ; 

disp 

+  = 

"\t" 

+ 

pqos 

i] 

. getAvailableBandwidth ( ) ; 

disp 

+  = 

+ 

pqos 

i] 

. getAvailableBandwidthIncludingBorrowing ( ) 

disp 

+  = 

+ 

pqos 

i] 

. getPacketDelay ( )  ; 

disp 

} 

+  = 

"\t" 

+ 

pqos 

i] 

.  getPacketLossRate ( )  ; 

disp  += 

=  " 

\n"; 

}  //  End  if  of  option  2 
}  //  End  loop  to  step  through  paths 
}  //  End  if  for  detailed  path  information 
return  disp; 

}  //  End  of  toStringPaths ( ) 
y  *  * 

*  Returns  a  string  will  all  interfaces  currently  in  the  PIB,  for  displaying 

*  purposes. 

*  Sreturn  String  the  string  with  all  interfaces  of  the  PIB. 

*/ 

public  String  toStringInterf aces ( ) 

{ 

//  Option  for  displaying  only  the  interface  addresses 
final  int  OPTION  =  0; 

return  toStringInterf aces (OPTION) ; 

}  //  End  of  toStringInterfaces ( ) 


y  *  * 

*  Returns  a  string  will  all  interfaces  currently  in  the  PIB,  for  displaying 

*  purposes.  Several  options  for  display  are  available  through  the  argument 

*  provided.  Different  detail  may  be  displayed. 

*  @param  int  for  the  option  of  display  (0,  1,  2  or  -1) 

*  @return  String  the  string  representation  of  the  interfaces 
*/ 

public  String  toStringInterf aces ( int  option) 

{ 

String  disp  =  new  String  (); 

Interfaceinfo  interfacelO  =  null; 

disp  =  "\n*****  Interfaces  in  the  PIB  *****\n"; 
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if (option  <  -1  I  I  option  >  2) 

{ 

option  =  -1; 

} 

if (option  ==  -1 ) 

{ 

disp  += 

"  Following  display  options  are  available : \n"  + 

"  0  ;  List  all  interfaces  \n"  + 

"  1  ;  List  all  interfaces  and  pathsXn"  + 

"  2  ;  List  all  interfaces  and  their  QoS  parametersXn"  + 

"  -1  ;  Display  this  help  information  and  the  total  no.  of  pathsXn" 


disp  +=  "\n\tTotal;  "  +  htinterfaces . size ( )  +  "\n"; 
if (option  ! =  -1 )  { 

Enumeration  enum  =  htinterfaces . keys () ; 
disp  +=  "\nlnterface  Address\t\tNode  ID"; 

while  (enum.hasMoreElements ( ) ) 

{ 

//IPv6Address  interfaceAddress  =  (IPv6Address)  enum. nextElement ( ) ; 
String  addressString  =  (String)  enum. nextElement () ; 
disp  +=  "\n\t"  +  addressString; 

interfacelO  = 

( Inter face Info)  htinterfaces . get (addressString)  ; 

disp  +=  "\t"  +  interfacelO. getNodelD 0  ; 

if  (interfacelO  ==null)  { 

disp  +=  "\n\n  interfacelO  ==  null"; 
return  disp; 

} 

//Display  paths  transversing  this  interface  (option  1) 
if  (option  ==  1) 

{ 

Hashtable  table  =  interfacelO. getPathIDs () ; 

Enumeration  enumTable  =  table . elements () ; 

while  (enumTable . hasMoreElements () ) 

{ 

Integer  currentPathID  = (Integer)  enumTable . nextElement () ; 
disp  +=  "\n\t\tPath  ID:  "  +  currentPathID. intValue () ; 

}  //  End  of  pathID  display  block 
}//end  if 

//Display  QoS  parameters  (option  2  or  3) 
if  (option  ==  2) 

{ 

disp  +=  "\tTotal  BW  =  "  + 

(int) (interfacelO. getTotalBandwidth 0 /lOOO )  +  "  kbps"; 
disp  +=  "\tUA  BW  =  "  + 

(int) (interfacelO. getUnallocatedBandwidth 0 /lOOO )  +  "  kbps"; 
ObsQoS[]  qos  =  interf acelO . getQoS ( ) ; 
disp  +=  "\n\n  "  + 

"SL  BaseXtIn  use\tAvBW\tAvBW-B\tBC\tUtil\tUtil%\tDelay\tLoss  Rate 

for  (byte  si  =  0;  si  <  qos. length;  sl++) 

{ 

int  borrowingCapacity  = 

interfacelO . getServiceLevelBorrowingCapacity ( si ) ; 
int  avBWwBorrowing  = 

interf acelO . getServiceLevelAvailableBandwidth (si) ; 
if (si  ==  INT_SERV)  { 
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avBWwBorrowing  += 

interf acelO . getServiceLevelBorrowingCapacity ( DIFF_SERV) ; 

} 

if (si  ==  DIFF_SERV)  { 
avBWwBorrowing  += 

interf ace 10 . getServiceLevelBorrowingCapacity ( INT_SERV) ; 

} 

String  utilPct  =  String . valueOf ( 

Math . abs (qos [ si ] . getUtilization ( )  *  ServiceSA.UTIL_UNIT  *  100) 


disp  +=  "\n  "  + 

//column  1  -  service  level 
si  +  "  "  + 

//columns  2  -  base  allocation 

( (int) ( (double) interfacelO. getTotalBandwidth ( )  /  1000  * 
afBASE_ALLOCATION [si]  *  af LOAD_FACTOR [ sl ] ) )  +  "  \t"  + 

//columnn  3  -  current  utilization 

(int) ( (double) qos [sl] . getUtilization ( )  *  ServiceSA.UTIL_UNIT  * 
(double) interfacelO. getTotalBandwidth ( )  /  1000)  +  "\t"  + 

//columnn  4  -  available  bandwidth 

(int) ( interf acelO . getServiceLevelAvailableBandwidth ( sl )  /  1000)  + 
"\t"  + 

//column  5  -  available  bandwidth  with  borrowing 
(int) (avBWwBorrowing  /  1000)  +  "\t"  + 

//column  6  -  capacity  available  for  borrowing 
(int) (borrowingCapacity  /  1000)  +  "\t"  + 

//column  7  -  utilization  as  stored  in  pib 
qos [sl] . getUtilization ( )  +  "\t"  + 

//column  8  -  utilization  as  percentage  of  total  bandwidth 
(((int)  (1000  *  (qos  [sl]  . getUtilization  ( )  * 

ServiceSA.UTIL_UNIT) ) ) /lO)  +  "\t"  + 

//column  9  -  delay  as  stored  in  pib 
qos [sl] . getDelay ( )  +  "\t"  + 

//columnc  10  -  loss  rate  as  stores 
qos [sl] . getLossRate ( ) ; 

}  //End  of  iterface  QoS  display  block 

disp  +=  "\n\n"; 

}//End  if 

}  //End  of  loop  traversing  the  interfaces  hashtable 

} 

return  disp; 

}  //  End  toStringInterfaces ( ) 

/  *  * 

*  Returns  a  string  with  the  observed  QoS  parameters  of  a  interface  and  for  a 

*  given  service  level.  Appropriate  for  displaying  purposes. 

*  @param  obs  the  obsQoS  object. 

*  @param  interfaceAddress  the  IPv6  address. 

*  @param  bSL  the  service  level. 

*  @return  the  string  wiht  observed  QoS  parameters  for  display. 

*/ 

public  String  toStringObservedQoS  ( 

ObsQoS  obs, 

IPvOAddress  interfaceAddress, 
byte  bSL) 
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{ 

string  str  = 

"Observed  Quality  of  Service  for  Interface  "  + 
interf aceAddress  +  "  Service  Level  "  +  bSL  +  "  is:  \n"; 
str  +=  "Utilization:  "  +  obs . getUtilization ( )  +  "\n"; 
str  +=  "Delay:  "  +  obs . getDelay  ( )  +  "\n"; 
str  +=  "LossRate:  "  +  obs . getLossRate ( )  +  "\n\n"; 
return  str; 

}  //  End  of  toStringObservedQoS ( ) 


y  *  * 

*  Returns  a  string  representation  QoS  attributes  of  a  given  path  and  for  a 

*  given  service  level. 

*  @param  pathQoS  the  path  QoS  object  for  the  given  service  level. 

*  @param  pathID  the  path  ID. 

*  @param  bSL  the  service  level. 

*  @return  the  string  representating  the  QoS  attributes  of  the  path  for  the 

*  given  servicel  level. 

*/ 

public  String  toStringPathQoS ( PathQoS  pathQoS,  Integer  pathID,  byte  bSL) 

{ 

String  str  = 

"Path  Quality  of  Service  for  Path  "  + 

pathID. intValue ( )  +  "  Service  Level  "  +  bSL  +  "  is:  \n"; 
str  +=  "Path  Available  Bandwidth:  "  +  pathQoS . getAvailableBandwidth ( )  +  "\n 
str  +=  "Delay:  "  +  pathQoS . getPacketDelay ( )  +  "\n"; 
str  +=  "LossRate:  "  +  pathQoS . getPacketLossRate ( )  +  "\n\n"; 

return  str; 

}  //  End  toStringPathQoS ( ) 

//[PS]  -  redesigned  to  support  of  inter-service  borrowing  and  to  improve 
//efficiency 
y  *  * 

*  Receives  and  processes  a  LSA  -  extracts  the  vector  of  ISAs,  determines  the 

*  type  of  each  ISA  (Add,  Remove  or  Update)  and  processes  each  of  them  in 

*  sequence  according  to  their  type. 

*  @param  LSA  a  LinkStateAdvertisement  object. 

*  @return  void. 

*/ 

public  void  processLSA  (LinkStateAdvertisement  LSA) 

{ 

//  Increase  the  LSA  counter 
iLsaCounter++; 

Vector  interfaceSAs  =  LSA. getInterfaceSAs ( ) ; 

IPvGAddress  routerlD  =  LSA. getMylPvG ( ) ; 

testMsg ( "processLSA ( ) " ) ; 

boolean  isNewRouter  =  false; 

Integer  thisNodelD  =  (Integer)  htRouterlDtoNodelD. get (routerlD. toString ()) ; 
String  strNodelD  = 

(thisNodelD  ==  null)  ?  "new  router"  :  thisNodelD . toString () ; 
display. sendText ( 

"\nProcess  LSA  number  "  +  iLsaCounter  +  "\n"  + 

"\tRouter  /  Node  ID;  \t"  +  routerlD  +  "  /  "  +  strNodelD) ; 

if  (thisNodelD  ==  null)  //  LSA  is  from  a  new  NODE 

{ 

//  If  it  is  a  New  Node,  assign  it  a  new  NodelD 

//  then  place  the  router  in  the  router/node  and  node/router  look-up  table 
thisNodelD  =  new  Integer (iNextNodeID++) ; 

htRouterlDtoNodelD . put ( routerlD . toString ( ) ,  thisNodelD) ; 
htNodelDtoRouterlD.put (thisNodelD,  routerlD) ; 
isNewRouter  =  true; 

}//  End  if  for  new  router  detection 

//  Step  through  the  list  of  ISA's  and  process  each  according  to  its  type 
Enumeration  enumISAs  =  interf aceSAs . elements () ; 
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while  (enumISAs .hasMoreElements ( ) )  //  Step  through  each  ISA  in  turn 

{ 

testMsg ( "Start  processing  new  ISA"); 

InterfaceSA  thisISA  =  ( Interf aceSA)  enumISAs . nextElement () ; 
byte  type  =  thisISA. getInterfaceSAType () ; 

//  Use  simple  if  structure  to  determine  the  type  of  ISA 
switch (type) 

{ 

case  InterfaceSA. UPDATE:  //Update  Interface  type 

try 

{ 

testMsgC'ISA  of  type  update.  Going  to  update  interface..."); 
updateinterface (thisISA) ; 

} 

catch  (Exception  e) 

{ 

display . sendText ("!!! An  exception  occurred  in  updating  interface!") 
e .print StackTr ace ( ) ; 

} 

break; 

case  Interf aceSA. REMOVE :  //  Remove  Interface  type 
try 
{ 

testMsgC'ISA  of  type  remove.  Going  to  remove  interface"); 
removeinterf ace (thisISA) ; 
displayPIB  ( ) ; 

} 

catch  (Exception  e) 

{ 

display . sendText ("!!! An  exception  occurred  in  removing  interface!") 
e .print StackTr ace  ( ) ; 

} 

break; 

case  InterfaceSA. ADD;  //  Add  Interface  type 
try 
{ 

testMsgC'ISA  of  type  add.  Going  to  add  an  interface"); 
addinterface (thisISA,  thisNodelD,  routerlD,  isNewRouter) ; 
isNewRouter  =  false;  //no  longer  new  router  for  additional  interfs 

} 

catch  (Exception  e) 

{ 

display . sendText ("!!! An  exception  occurred  in  adding  interface!"); 
e .printStackTrace ( ) ; 

} 

break; 

default:  //  Undefined  type  of  ISA 

display . sendText ( "Undefined  type  of  ISA."); 

} 

}  //  End  while  statement  processing  vector  of  ISAs 
}  //  End  processLSAO 
/  *  * 

*  Adds  a  new  interface  to  the  PIB. 

*  @param  thisISA  the  ISA  object  containing  the  interface  description. 

*  @param  thisNodelD  the  ID  of  the  node  hosting  the  interface. 

*  @param  routerlD  the  router  ID  (IPv6Address)  of  the  hosting  rounter. 

*  @param  isNewRouter  whether  this  is  the  first  interface  of  the  hosting 

*  router. 

*  @return  void. 

*/ 

protected  void  addinterface ( 

InterfaceSA  thisISA, 

Integer  thisNodelD, 
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IPvGAddress  routerlD, 
boolean  isNewRouter) 

int  iBandwidth  =  thisISA. getBandwidth ( ) ; 

byte  subnetMask  =  thisISA. get Inter face SubnetMask ( ) ; 

IPvGAddress  interfacelD  =  thisISA. getlnterfacelP () ; 

testMsg ( "addinterf ace ( ) " ) ; 

display. sendText ( "\tAdd  interface : \t\t"  +  interfacelD) ; 

//  Determine  if  the  interface  already  exists  in  the  Interfaces  hashtable 
//  --  Can't  use  interfacelD  object  directly  as  key  because  objects  with 
//  --  same  content  may  still  have  different  hash  codes. 

//  Process  only  new  interfaces 

if  (  ! ht Interfaces . containsKey (interfacelD. toSt ring ( ) ) ) 

{  //  If  its  a  new  interface,  it  must  have  a  new  information  object 
//  created  to  contain  its  key  info: 

//  -  host  node  ID 

//  -  total  bandwidth  capacity 

//  -  subnet  mask  for  the  network  to  which  it  belongs 

//  -  and  a  hashtable  to  store  the  path  IDs  of  all  paths  that  traverse  it 

Interfaceinfo  interfaceInformationObject  =  new 

Interfaceinfo (thisNodelD,  iBandwidth,  subnetMask,  new  Hashtable  ()) ; 

//  Place  the  new  interface  in  the  table  of  all  interfaces 
ht Interfaces .put (interfacelD. toSt ring ( ) ,  interfaceInformationObject) ; 

if  (isNewRouter) 

{  //Create  an  entry  into  Routerinterf aceMap 

Hashtable  htThisNodeInterfaces  =  new  Hashtable (); 

htThisNode Interfaces . put ( interfacelD . toString ( ) ,  interfacelD) ; 

htRouter I nterf aceMap .put (router ID. toString ( ) ,  htThisNodeInterfaces) ; 

display . sendText ( "\t  This  is  a  new  router:  \t"  +  routerlD) ; 

} 

else 

{  //  Extract  the  sequence  of  interfaces  hosted  on  a  specific  router  and 
//  append  the  new  interface  to  the  referenced  sequence 
(  (Hashtable)  htRouter I nterf aceMap . get (routerlD. toString ( ) ) )  . 
put  (interfacelD. toString ( ) ,  interfacelD) ; 

} 


//  Determine  neighbor  interfaces  for  the  interface  we  are  adding. 

//  This  is  accomplished  by  comparing  the  network  addr  of  the  new  interface 
//  with  the  network  address  of  each  known  interface  until  a  match  is  found 
IPv6Address  thisNetwork  =  interfacelD. getNetworkAddress (subnetMask) ; 
Enumeration  enumRouters  =  htRouterInterfaceMap . elements () ; 

//  Step  through  each  router 

while  (enumRouters .hasMoreElements ( ) ) 

{ 

Hashtable  NextRouter  =  (Hashtable)  enumRouters . nextElement () ; 

Enumeration  enuminterf aces  =  NextRouter . elements () ; 

//  Step  through  each  of  the  candidate  router's  interfaces 
while  (enuminterfaces .hasMoreElements () ) 

{ 

IPvGAddress  neighborInterfacelD  = 

( IPvGAddress )  enuminterfaces . nextElement ( ) ; 

IPvGAddress  nextNetwork  = 

neighborInterfacelD. getNetworkAddress (subnetMask) ; 

//  We  now  compare  networkIDs.  If  they  are  equal  we  know  interfaces 
//  are  neighbors  and  commence  updating  the  aPI,  PathIDs,  and 
//  RouterInterfaceMap  hashtable. 
if  (nextNetwork. equals (thisNetwork) ) 

{  //Extract  the  interface  object  that  describes  the  interface 
Interfaceinfo  neighborInfoOb j  = 

(Interfaceinfo)  ht I nterf aces . get (neighborInterfacelD . toString ( ) ) 
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Integer  neighborNodelD  =  neighborInfoOb j . getNodelD ( ) ; 


display. sendText ( 

"\t 

Matching  subnet 

ok !  \n" 

+ 

"\t 

My  node  ID: 

\t" 

+  thisNodelD  +  "\n"  + 

"\t 

My  neighbor  node 

ID:  \t' 

'  +  neighborNodelD) ; 

if  (  ! neighborNodelD . equals (thisNodelD) ) 

{ 

//  modify  the  aPI  and  hashtables  to  add  new  paths 
createPaths  ( 
thisNodelD, 
neighborNodelD, 
interfacelD, 
neighborinterf acelD, 
iBandwidth, 
isNewRouter) ; 

//  exit  from  while  loop  assuming  point-to-point  link; 

//  each  interface  has  only  one  neighbor 
break; 

} 

}//  End  if-statement  processing  new  subnet  pair 
}//  End  while-statement  stepping  through  a  candidate  router’s  interfaces 
}//  End  while-statement  stepping  through  routers 
displayPIB ( ) ; 


} 

else 

{ 

display . sendText ( "\t  "  + 

"Can't  add  the  interface  because  it  is  already  in  htinterfaces  table!"); 
}  //  End  if-statement  preventing  ADD  of  an  existing  interface 

}//  End  addinterface ( ) ; 

/  *  * 

*  Created  new  paths  after  adding  the  new  interface  to  the  PIB. 

*  @param  newInterfaceNodelD  the  IPv6  address  ID  of  the  router  providing  the 

*  new  interface. 

*  @param  neighborNodelD  the  ID  of  the  neighbor  node. 

*  @param  newInterfacelD  the  IPv6  address  of  the  new  interface. 

*  @param  neighborInterfacelD  the  IPv6  address  of  the  neighbor  interface. 

*  @param  iBandwidth  the  bandwidth  of  the  new  interface 

*  @param  boolean  whether  the  interface  is  the  first  of  the  router 

*  @return  void 
*/ 

protected  void  createPaths  ( 

Integer  newInterfaceNodelD, 

Integer  neighborNodelD, 

IPv6Address  newInterfacelD, 

IPv6Address  neighborInterfacelD, 
int  iBandwidth, 
boolean  isNewRouter) 

{ 

//  Create  one-hop  paths  between  the  neighbor  nodes 

createOneHopPath  (newInterfaceNodelD,  neighborNodelD,  newInterfacelD, 
neighborInterfacelD,  iBandwidth) ; 

//  Create  multi-hop  paths  eminating  from  each  of  the  neighbor  nodes 
createMultiHopPath  (newInterfaceNodelD,  neighborNodelD,  newInterfacelD, 
neighborInterfacelD,  iBandwidth,  isNewRouter) ; 

//  Create  combined  paths  originating  and  terminating  at  nodes  other  than 
//  the  neighbors,  but  which  include  the  neighbors 
if  (! isNewRouter ) 

{ 

createCombinedPath  (newInterfaceNodelD,  neighborNodelD,  newInterfacelD, 
neighborInterfacelD,  iBandwidth) ; 
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} 

}  //  End  of  createPaths ( ) 


/  *  * 

*  Creates  a  single  hop  path  between  two  given  interfaces. 

*  @param  newInterfaceNodelD  the  ID  of  the  node  providing  the  new  interface 

*  @param  neighborNodelD  the  ID  of  the  neighbor  node. 

*  @param  newInterfacelD  the  IPv6  address  of  the  new  interface. 

*  @param  neighborInterfacelD  the  IPv6  address  of  neighbor  interface. 

*  @param  iBandwidth  the  bandwidth  of  the  new  interface. 

*  @return  void 
*/ 

protected  void  createOneHopPath ( 

Integer  newInterfaceNodelD, 

Integer  neighborNodelD, 

IPv6Address  newInterfacelD, 

IPv6Address  neighborInterfacelD, 
int  iBandwidth) 

{ 

//  Generate  newPathID  to  aPI  Index  for  intitial  route  (i.e.  A->B) 
short  newPathID  =  iNextPathID++; 

//  Append  the  new  path  ID  to  the  hashtable  in  the  corresponding  aPI  element 
aPI [newInterfaceNodelD . intValue ( ) ] [neighborNodelD . intValue ()][!]. 
put (new  Integer (newPathID) ,  new  Integer (newPathID) ) ; 

//  Create  a  new  Path  with  the  new  PathID 
Integer  x  =  new  Integer (newPathID) ; 

aPIIndex  y  =  new  aPIIndex (newInterfaceNodelD,  neighborNodelD,  1); 

Path  newPath  = 

new  Path(x,  y,  newInterfacelD,  neighborInterfacelD,  iBandwidth); 

//  Add  path  to  the  htPaths  hashtable 
htPaths .put (new  Integer (newPathID) ,  newPath) ; 

//  Extract  interface  object  for  new  interface  ID 
Interface Info  outboundInterfaceOb j  = 

( Interface Info)  ht Interfaces . get (newInterfacelD . toString ( ) ) ; 

//  Add  newPathID  to  the  pathID  table  contained  in  the  htinterfaces  hashtable 
//  which  is  contained  in  the  information  object  for  interface  newInterfacelD 
Hashtable  pathsThruInterface  =  outboundInterfaceOb j .getPathIDs () ; 
pathsThruInterface.put (new  Integer (newPathID) ,  new  Integer (newPathID) ) ; 

//  Create  a  path  in  the  opposite  direction  (the  Path  constructor  updates  the 
//  necessary  tables) : 

Path  mirrorNewPath  =  new  Path  (newPath) ; 

//  [GX-mirror]  for  single  hop  paths,  no  optimization;  have  to 
//  rely  on  network  id  matching  to  find  outbound  interfaces  for 
//  mirrored  paths 
/* 

mirrorNewPath . setMirror (newPath) ; 
newPath . setMirror (mirrorNewPath) ; 

*/ 


}  //  End  CreateOneHopPath ( ) 


y  *  * 

*  Creates  a  multi-hop  path,  originating  at  each  of  the  two  interfaces,  i.e., 

*  the  newly  added  interface  and  its  neighbor  interface  in  the  neighbor  node. 

*  Appends  one  interface's  node  and  interface  to  each  path  originating  at  the 

*  other  interface  and  going  away  from  the  new  link. 

*  @param  newInterfaceNodelD  the  ID  of  the  node  hosting  the  new  interface. 

*  @param  neighborNodelD  the  ID  of  the  neighbor  node. 

*  @param  newInterfacelD  the  IPv6  address  of  the  new  interface. 

*  @param  neighborInterfacelD  the  IPv6  address  of  the  neigbor  interface. 

*  @param  iBandwidth  the  interface  bandwidth. 

*  @param  whether  the  new  interface  is  the  first  interface  of  the 
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*  rounter  and  so  is  a  new  router. 

*  @return  void. 

*/ 

protected  void  createMultiHopPath  ( 

Integer  newInterfaceNodelD, 

Integer  neighborNodelD, 

IPvGAddress  newInterfacelD, 

IPvGAddress  neighborInterfacelD, 
int  iBandwidth, 
boolean  isNewRouter) 

{ 

//  Step  1  -  Create  path  originating  at  the  newInterfaceNode  and  going 
//  through  the  neighbor  node  on  the  first  hop: 

//[GX]:  Need  to  associate  a  flag  with  each  node  id  to  indicate  that  it  is  a 
//live  node 

for (  int  Destinationindex  =  0; 

Destinationindex  <  MAX_NODE_NUMBER; 

DestinationIndex++) 

{ 

//  Verify  that  Destination  Index  is  not  the  same  as  Neighbor  Node  or  the 
//  new  interface  node.  This  prevents  process  from  searching  for  a  path 
//  that  has  a  source  and  destination  index  as  the 
//  same,  (i.e.,  aPI [A] [A] [h] ) 

if  (neighborNodelD. intValue ( )  ==  Destinationindex  | | 
newInterfaceNodelD. intValue ( )  ==  Destinationindex) 

{ 

continue; 

} 


for  (int  hopCount  =  1;  hopCount  <  MAX_HOP_COUNT  -  1;  hopCount++) 

{ 

//  Extract  PathIDs  from  aPI  array  containing  all  Path  IDs 
Enumeration  enumPathIDs  = 

aPI [neighborNodelD . intValue ( ) ] [ Destinationindex] [hopCount] . elements ( ) ; 

while  (enumPathIDs .hasMoreElements 0 )  //  Step  through  paths 

{ 

//  Extract  each  path  based  on  the  pathIDs  in  the  aPI  element  hashtable 
Integer  thisPathID  =  (Integer)  enumPathIDs . nextElement () ; 

Path  thisPath  =  (Path)  htPaths . get (thisPathID) ; 

//  Verify  that  added  node  is  not  already  in  vNodeSquence  which 
//  would  create  a  closed  loop  if  added  to  the  sequence, 
if  ( ! thisPath . vNodeSequence . contains (newInterfaceNodelD) ) 

{ 

//  Copies  references  contained  in  the  original  node  sequence 
//  vector (shallow  copy).  Does  not  duplicate  the  actual  sequence. 

//  Vector  nodeSequence  =  (Vector)  thisPath .vNodeSequence . clone () ; 
Vector  nodeSequence  =  (Vector)  thisPath . getNodeSequence () .clone () ; 

short  multiHopPathID  =  iNextPathID++;  //Create  new  multiHopPath  ID 

//  Create  the  multihop  Path 
System. out. println ( 

"[createMultiHopPath  1]:  path_id  =  "  +  multiHopPathID); 

Path  multiHopPath  = 

new  Path (  new  Integer (multiHopPathID) , 
thisPathID, 
new  aPI Index ( 

newInterfaceNodelD, 
new  Integer (Destinationindex) , 
hopCount  +  1), 
newinterf acelD, 
neighborinterf acelD, 
iBandwidth) ; 

//  Add  Path  to  htPaths  hashtable 

htPaths .put (new  Integer (multiHopPathID) ,  multiHopPath); 

//  Add  pathID  to  aPI  entry  for  source 
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aPI [newInterfaceNodelD. intValue ( ) ] [Destinationindex] [hopCount  +  1]. 
put (new  Integer  (multiHopPathID) ,  new  Integer  (multiHopPathID) ) ; 

//  Extract  list  of  interfaces  the  new  path  traverses  and  add  the 
//  hashtable  of  path's  ID  for  each  interface  traversed  then  replace 
//  the  table  entry 

Enumeration  enuminterf acesTraversed  = 

multiHopPath . get Interface Sequence ( ) .elements ( ) ; 
while  (enumInterfacesTraversed.hasMoreElements () ) 

{ 

IPvGAddress  address  = 

( IPv6Address )  enuminterf acesTraversed . nextElement ( ) ; 
Interfaceinfo  interfaceObject  = 

( Interface Info)  ht Interfaces . get (address . toString ( ) ) ; 

Hashtable  pathTable  = 

(Hashtable)  interfaceObject. getPathIDs () ; 
pathTable. put ( 

new  Integer (multiHopPathID)  , 
new  Integer (multiHopPathID) ) ; 

}  //  End  loop  through  interfaces  traversed 

//  Step  2  -  Create  a  path  in  the  opposite  direction  (the  constructor 
//  updates  the  necessary  tables) : 

//  [GX-mirror]  we  can  do  more  efficiently  since  we  can  retrieve  outbound 
//  interfaces  from  mirror  path  of  the  given  subpath 

Path  mirrorMultiHopPath  =  new  Path  (multiHopPath) ; 

}//  end  if  statement  preventing  creation  of  loop  paths 

}//  end  while  for  enumPathsIDs 

//  Step  3  -  Create  paths  originating  at  the  neighborNode  and  going 
//  through  the  newInterfaceNode  node  on  the  first  hop: 

//  Get  hashtable  of  pathIDs  for  paths  eminating  from  the  new  interface 
//  away  from  the  direction  of  the  neighbor 
if  ( ! isNewRouter ) 

{ 

Enumeration  enumReversePathIDs  = 

aPI  [newInterfaceNodelD. intValue ( ) ] 

[ Destinationindex] 

[hopCount] . elements ( ) ; 

while  (enumReversePathIDs .hasMoreElements () ) 

{  //  Extract  each  path  using  the  pathID  extracted  from  the  hashtable 
Integer  thisReversePathID  = 

(Integer)  enumReversePathIDs . nextElement ( ) ; 

Path  thisReversePath  =  (Path)  htPaths . get (thisReversePathID) ; 

//  Verify  that  added  node  is  not  already  in  vNodeSquence  which 
//  would  create  a  closed  loop  if  added  to  the  sequence, 
if  ( ! thisReversePath . vNodeSequence . contains (neighborNodelD) ) 

{  //  Copy  node  references  contained  in  the  original  node  sequence 
//  vector (shallow  copy).  Does  not  duplicate  the  actual  sequence. 
Vector  reverseNodeSequence  = 

(Vector)  thisReversePath .vNodeSequence . clone ( ) ; 

//append  added  nodelD  to  vReverseNodeSequence 
reverseNodeSequence . addElement (neighborNodelD) ; 

//Create  new  reverseMultiHopPath  ID 

short  reverseMultiHopPathID  =  iNextPathID++; 

//  Create  reverseMultihop  Path 
Path  reverseMultiHopPath  = 
new  Path ( 

new  Integer (reverseMultiHopPathID)  , 

thisReversePathID, 

new  aPI Index ( 
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neighborNodelD, 

new  Integer (Destinationindex)  , 
hopCount  +  1), 
neighborinterf acelD, 
newinterf acelD, 
iBandwidth) ; 

//  Add  Path  to  htPaths  hashtable 
htPaths ,put ( 

new  Integer (reverseMultiHopPathID) , 
reverseMultiHopPath)  ; 

//  Add  pathID  to  aPI  entry  for  source 
aPI  [neighborNodelD. intValue ( ) ] 

[ Destination Index] 

[hopCount  +  l].put( 

new  Integer (reverseMultiHopPathID) , 
new  Integer (reverseMultiHopPathID) ) ; 

//  Update  each  traversed  Interface's  Interfaceinfo . 

Enumeration  enumReverseEf f ectedinterf aces  = 

reverseMultiHopPath . vinterf aceSequence . elements () ; 

while  (enumReverseEffectedInterfaces .hasMoreElements () ) 

{ 

IPvGAddress  nextAddress  = 

( IPvGAddress )  enumReverseEffectedInterfaces . nextElement ( ) ; 

//  Extract  interface  object  for  nextEf fectedInterfacelD 
Interfaceinfo  effectedReverseInterfaceObject  = 

(Interfaceinfo)  ht Interfaces . get (nextAddress . toString ( ) ) ; 

//  Extract  the  pathID  hashtable  for  the  effected  interface 
//  and  add  the  new  pathID  to  it 
Hashtable  tempReverseEf fectedPathIDTable  = 
effectedReverseInterfaceObject. getPathIDs () ; 

tempReverseEf fectedPathIDTable .put  ( 

new  Integer (reverseMultiHopPathID) , 
new  Integer (reverseMultiHopPathID) ) ; 

}  //  End  loop  to  update  interface  information  objects  with 
//  new  path  ID 

//  Step  4  -  Create  a  path  in  the  opposite  direction  (the 
//  constructor  updates  the  necessary  tables) : 

Path  MirrorReverseMultiHopPath  =  new  Path  (  reverseMultiHopPath  ) 

}  //  End  if  statement  preventing  closed  loop  paths 

}  //  End  while  for  enumReversePathsIDs 

}  //  End  if  for  new  node  check 

}  //  End  for  loop  indexed  by  hop  count 

}  //  End  for  loop  indexed  by  Max_Node_Number 

}  //  End  of  createMultiHopPath ( ) 


y  *  * 

*  Creates  a  combined  path  by  concatenating  pairs  of  paths  terminating  at 

*  respectively  the  new  interface  and  the  neighbor  interface. 

*  Algorithm: 

*  For  any  pair  of  paths  such  that  Path(i)  terminates  at  node(i)  and 

*  Path(j)  begins  at  node(j)  and  does  not  terminate  at  node(i), 

*  if  no  element  of  Path(i) . vNodeSequence  is  contained  in 

*  Path (j ) .vNodeSequence  then  create  new  Path(k)  =  Path(i)  +  Path(j) 

*  @param  newInterfaceNodelD  the  node  ID  of  the  node  hosting  thenew  interface. 

*  @param  neighborNodelD  the  node  ID  of  the  neighbor  node. 

*  @param  newInterfacelD  the  IPv6  address  of  the  new  interface. 
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*  @param  neighborInterfacelD  the  IPv6  address  of  the  neighbor  interface. 

*  @param  iBandwidth  the  inteface  bandwidth. 

*  @return  void 
*/ 

protected  void  createCombinedPath  ( 

Integer  newInterfaceNodelD, 

Integer  neighborNodelD, 

IPvGAddress  newInterfacelD, 

IPvGAddress  neighborInterfacelD, 
int  iBandwidth) 

{ 

//  Step  1  -  find  a  pair  of  candidate  paths  to  be  concatenated: 

//  For  all  possible  source  nodes  not  equal  to  the  newInterfaceNodelD 
//  nor  the  neighborNodelD: 

for  (int  Sourceindex  =  0;  Sourceindex  <  MAX_NODE_NUMBER;  SourceIndex++) 

{ 

//  Do  not  consider  paths  originating  at  either  the  new  iFace 
//  or  its  neighbor 

if  (Sourceindex  !=  newInterfaceNodelD. intValue ( )  && 

Sourceindex  !=  neighborNodelD. intValue () ) 

{ 

//  For  all  hop  counts  for  the  source  path: 

for  (int  SourceHops  =  1;  SourceHops  <  MAX_H0P_C0UNT  -  1;  SourceHops++) 

{ 

//  Extract  the  aPI  element  (hashtable  of  pathIDs) 

//  for  this  source,  the  new  interface,  and  this  hop  count 

Hashtable  htSourcePaths  = 

aPI [Sourceindex] [newInterfaceNodelD. intValue () ] [SourceHops] ; 

//  For  all  possible  destination  nodes  not  equal  to  either  the 
//  newInterfaceNodelD  or  neighborNodelD,  and  where  the  combined  hop 
//  count  is  less  than  the  maximum  so  that  the  addition  of  the  new 
//  link  will  not  result  in  too  long  of  a  path: 
for  (  int  Destinationindex  =  0; 

Destinationindex  <  MAX_NODE_NUMBER; 

DestinationIndex++  ) 

{ 

//  Do  not  consider  paths  ending  at  either  the  new  interface 
//  or  its  neighbor 

if  (Destinationindex  !=  newInterfaceNodelD. intValue ( )  && 
Destinationindex  !=  neighborNodelD. intValue () ) 

{ 

//  For  all  hop  counts  for  the  destination  path: 
for  (  int  DestinationHops  =  1; 

DestinationHops  +  SourceHops  <  MAX_H0P_C0UNT  -  1; 
DestinationHops++) 

{ 

//  Extract  the  pathID  hashtables  for  the  candidate  destination 
//  paths 

//  where  the  aPI  indexes  are: 

Hashtable  htDestinationPaths  = 

aPI  [neighborNodelD. intValue  0 ] 

[ Destinationindex] 

[DestinationHops] ; 

//  Traverse  the  pathID  hashtables  in  pairs  such  that  each 
//  potential  path  combination  is  considered.  For  each  pair 
//  extract  the  path  pairs  from  the  paths  hashtable  and 
//  extract  the  node  sequences  for  each  path.  Ensure  that  each 
//  node  of  the  second  path's  vector  is  not  included  in  the  first 
//  path's  node  sequence  vector. 

Enumeration  enumSourcePathIDs  =  htSourcePaths . elements () ; 
while  (enumSourcePathIDs .hasMoreElements ( )  ) 

{ 

Integer  iNextSourceCandidate  = 

(Integer)  enumSourcePathIDs . nextElement ( ) ; 

Path  pCandidateSource  = 

(Path)  ht Paths . get (iNextSourceCandidate) ; 

Enumeration  enumDestinationPathIDs  = 


122 


htDestinationPaths .elements ( ) ; 


while  (enumDestinationPathIDs .hasMoreElements () ) 

{ 

Integer  INextDestinationCandidate  = 

(Integer)  enumDestinationPathIDs . nextElement ( ) ; 

Path  pCandidateDestination  = 

(Path)  ht Paths . get (INextDestinationCandidate) ; 

//  Determine  if  the  candidate  paths  have  any  common  nodes 
//  by  checking  each  node  vector  of  the  candidate  source  path 
//  for  inclusion  in  the  node  vector  of  the  candidate 
//  destination  path 

//assume  no  common  node  between  the  path  pair 
boolean  boolNoCommonNode  =  true; 

Enumeration  enumSourcePathNodes  = 

pCandidateSource . getNodeSequence ( ) . elements ( ) ; 

while  (enumSourcePathNodes .hasMoreElements ( )  ) 

{ 

//  If  a  common  node  is  found  the  source  and  destination 
//  pair  of  paths  can  not  be  concatenated  without  forming 
//  a  closed  loop.  Thus,  if  a  common  node  is  found  do  not 
//  continue  checking  the  remaining  nodes  in  the  sequence. 
//  Set  a  flag  to  ensure  a  new  path  is  not  created  for  the 
//  path  pair. 

if  (pCandidateDestination . getNodeSequence ( ) . 

contains (enumSourcePathNodes . nextElement ( ) )  ) 

{ 

boolNoCommonNode  =  false; 
break; 

} 

//  Current  path  pair  contains  a  common  node  -  precede  to 
//  next  destination  candidate 

}  //  End  of  while  loop  to  test  for  common  nodes 

//  Step  2  -  If  no  common  node  is  found  generate  a  new  path 
//  by  concatenating  the  two  candidate  paths: 
if  (boolNoCommonNode) 

{ 

Path  pConcatenatedPath  = 
new  Path  ( 

pCandidateSource, 
pCandidateDestination, 
newInterfacelD, 
neighbor Inter face ID, 
iBandwidth  ) ; 

//  Add  path  to  the  htPaths  hashtable 
Integer  iConcatenatedPathID  = 
pConcatenatedPath . getPathID  ( ) ; 
htPaths .put (iConcatenatedPathID,  pConcatenatedPath) ; 

System. out. println (" [createCombinedPath] ;  path_id  =  "  + 
iConcatenatedPathID) ; 

//  Add  pathID  to  aPI  entry  for  concatenated  path: 

//  note  that  the  hop  count  must  include  the  link  between 
//  the  two  paths 
aPI  [Sourceindex] 

[ Destination Index] 

[SourceHops  +  DestinationHops  +  1]. 
put (iConcatenatedPathID,  iConcatenatedPathID) ; 

//  Add  the  pathID  to  each  traversed  interface's  hashtable 
//  of  pathIDs 

Enumeration  enumpConcatenatedPathInterf acesTraversed  = 
pConcatenatedPath . getInterfaceSequence () .elements () ; 
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while  (enumpConcatenatedPathInterf acesTraversed . 
hasMoreElements () ) 

{ 

IPv6Address  concatAddress  = 

( IPv6Address ) enumpConcatenatedPathInterf acesTraversed . 
nextElement ( ) ; 

Interfaceinfo  concatObject  = 

( Inter face Info) ht Inter faces . 
get (concatAddress . toString ( ) ) ; 

Hashtable  concatTable  = 

(Hashtable)  concatObject . get Path IDs ( ) ; 

concatTable .put (iConcatenatedPathID, iConcatenatedPathID) 

}  //  End  of  while  loop  to  update  interface  hashtables 

//  Step  3  -  Create  mirror  path  from  destination  to  source 
//  (constructor  updates  necessary  tables) ; 

Path  pMirrorConcatenatedPath  =  new  Path (pConcatenatedPath) 

}  //  End  if  to  create  concatenated  path 

}  //  End  of  destination  path  IDs 

}  //  End  of  source  path  IDs 

}  //  End  destination  hop  indexed  loop 

}  //  End  destination  test  (IF)  for  equality  of  destination  node  ID 
//  to  the  new  interface's  node  or  its  neighbor 

}  //  End  destination  indexed  loop 

}  //  End  source  hop  indexed  loop 

}  //  End  source  test  (IF)  for  equality  of  source  node  ID  to  the  new 
//interface's  node  or  its  neighbor 

}  //  End  source  indexed  loop  for  concatenating  two  paths  joined  by  the  newly 
//  added  interface 

}  //  End  of  createCombinedPath ( ) 


/  *  * 

*  Removes  an  interface  from  the  PIB,  given  an  ISA  object. 

*  @param  thisISA  the  InterfaceSA  object  with  the  information  about  the 

*  interface  to  be  removed. 

*  @return  void 
*/ 

protected  void  removeinterface ( InterfaceSA  thisISA) 

{ 

testMsg ( "removeinterface ( ) " )  ; 

IPvGAddress  interfaceAddress  =  thisISA. getlnterfacelP () ; 

display . sendText ( "Removing  interface:  "  +  interfaceAddress); 

//  Get  the  Interfaceinformation  object  from  the  htinterfaces 
Interfaceinfo  interfaceinformation  = 

(Interfaceinfo)  htinterfaces . get (interfaceAddress . toString ( ) ) ; 

//  Extract  the  table  of  path  IDs  for  paths  traversing  the  interface 
Hashtable  interfacePathIDs  =  interfaceinformation . getPathIDs () ; 
Enumeration  enum  =  interfacePathIDs . elements () ; 

//  Step  through  each  path  in  the  interface's  pathID  table 
while  (enum. hasMoreElements 0 ) 

{ 

Integer  pathID  =  (Integer)  enum. nextElement () ; 

//  Delete  the  path  from  the  PIB  path  table 
Path  path  =  (Path)  htPaths . remove (pathID) ; 
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//  Extract  the  node  sequence  and  determine  the  associated  PIB  aPI  element 
Vector  nodeSequence  =  path . getNodeSequence ( ) ; 

Integer  source  =  (Integer)  nodeSequence . elementAt (nodeSequence . size ( )  -  1) 
Integer  destination  =  (Integer)  nodeSequence . elementAt (0 ) ; 
int  hopCount  =  nodeSequence . size ( )  -  1; 

//  Delete  this  pathID  from  aPI[] [] [] 

Integer  ipath  = 

(Integer)  aPI  [source . intValue () ] 

[destination . intValue ( ) ] 

[hopCount] . remove (pathID) ; 

//  Get  all  the  other  interfaces  this  path  traverses 
Vector  interfaceSequence  =  path . getInterfaceSequence ( ) ; 

Enumeration  enuminterf ace  =  interfaceSequence . elements () ; 

//  Step  through  each  interface  and  delete  the  path  ID  from  its  table 
while  (enumInterface.hasMoreElements () ) 

{ 

IPvGAddress  nextAddress  =  (IPvGAddress)  enuminterf ace . nextElement () ; 

//  Remove  the  interface  object  from  the  hashtable  for  updating  it 
Interfaceinfo  interfaceinfo  = 

( Interface Info)  ht Interfaces . get (nextAddress . toString ( ) ) ; 

//  Extract  the  path  ID  hashtable  from  the  interface  object 
Hashtable  interfacePaths  =  interfaceinfo . getPathIDs () ; 

//  Delete  the  pathID  from  the  path  ID  table  and  replace  the  iFace  obj . 
Integer  x  =  (Integer)  interfacePaths . remove (pathID) ; 

}//end  of  while  for  all  the  interfaces  which  the  path  goes  through 

}//end  of  while  for  all  the  paths  going  through  this  deleted  interface 

//  Remove  this  Interfaceinformation  object  from  the  htinterfaces 
Interfaceinfo  interfaceInformationRemove  = 

(Interfaceinfo)  htinterfaces . remove (interfaceAddress) ; 

display . sendText ( "Finished  removing  interface!"); 

}//end  of  removeinterface ( ) 

//  [PS]  -  redesigned  to  support  inter-service  borroiwng  and  to  improve 
//  efficiency 
/  *  * 

*  Processes  an  Interface  Status  Advertising  information  (ISA)  of  type  update. 

*  Strips  the  ISA  and  updates  the  referenced  interface  with  the  new  status 

*  information  retrieved  from  the  one  or  more  ServiceSAs  contained  in  the  ISA. 

*  @param  interfaceSA  the  InterfaceSA  object  containing  the  interface  info. 

*  @return  void. 

*/ 

protected  void  updateinterface ( InterfaceSA  interfaceSA) 

{ 

testMsg ( "updateinterface ( ) " ) ; 

//  [PS]  June  2001 

//  Flag  variable  used  to  display  message  about  interface  propagation  updates 
//  after  receiving  new  utilization  updates  for  IntServ  or  DiffServ.  With 
//  currentit  SAAM  prototype  it  is  possible  for  the  Link  State  Monitor  to 
//  advertise  0%  utilization,  event  thought  traffic  is  being  routed.  While  in 
//  test  mode,  because  all  traffic  is  virtually  generated  within  the  tester, 
//  LSA  updates  for  IntServ  and  DiffServ  won't  propagate, 
boolean  isUtilizationChangedForlSorDS  =  false; 

//</PS> 

//Flag  variable  -  true  to  flag  that  current  interface  has  changed 
boolean  isInterfaceChanged  =  false; 

//Local  support  variables  (initalized  with  value  of  zero) 
short[]  deltaDelay  =  new  short [NUM_OF_SERVICE_LEVELS ] ; 
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short[]  deltaLossRate  =  new  short [NUM_OF_SERVICE_LEVELS] ; 

//Retrieve  general  information  from  this  ISA 

IPv6Address  interfaceAddress  =  interfaceSA. getlnterfacelP ( ) ; 

byte  numberOfSSA  =  interfaceSA. getNumOf ServiceSA () ; 

Vector  serviceLevelSAs  =  interfaceSA. getServiceSAs () ; 

//Retrieve  the  interface's  information  object  from  the  interface  hashtable 
Interfaceinfo  interfaceinformation  = 

( Inter face Info) ht Inter faces . get (interfaceAddress . toString ( ) ) ; 

//Check  if  the  interface  indeed  exists 
if  (interfaceinformation  ==  null) 

{ 

//Interface  does  not  exist  in  the  PIB  -  display  message  and  return 
display. sendText  ( 

"\tlnterface  object  not  found  from  htinterfaces  hashtable:  "  + 

"can't  process  this  ISA." 

)  ; 

return; 

} 


//Interface  exists,  lets  proceed 

display . sendText ( "\tUpdating  interface : \t"  +  interfaceAddress); 

//Retrieve  array  of  QoS  parameters  about  the  current  interface 
ObsQoS[]  qosArray  =  interfaceinformation . getQoS () ; 

//Cycle  through  the  SSAs  contained  in  the  ISA,  one  at  a  time 
for  (byte  i  =  0;  i  <  numberOfSSA;  i++) 

{ 

testMsg ( "Processing  SSA  #  "  +  (i  +  1)  +  "  of  "  +  (numberOfSSA)); 

//Retrieve  an  SSA  and  its  service  level 

ServiceSA  thisServiceLevelSA  =  (ServiceSA)  serviceLevelSAs . elementAt ( i ) ; 
byte  bSL  =  thisServiceLevelSA. getServiceLevel () ; 

//Currently,  we  do  not  handle  updates  for  this  service  level, 
if  (bSL  ==  0UT_PR0FILE) 

{ 

continue;  //jump  over  this  iteration;  no  updates  for  Out  of  Profile  SL 

} 

//Retrieve  the  metric  type 

byte  metricType  =  thisServiceLevelSA. getMetricType () ; 

switch (metricType) 

{ 

case  ServiceSA. UTILIZATION_TYPE ;  //utilization  update 

short  oldUtilization  =  qosArray [bSL]  . getUtilization  () ; 
short  utilization  =  thisServiceLevelSA.getUtilizationO; 

if (Math . abs (utilization  -  oldUtilization)  >=  thresholdUtilization) 

{ 

//Utilization  has  changed  significantly  -  must  update 
isInterfaceChanged  =  true; 

qosArray [bSL] . setUtilization (utilization) ; 

//new  bandwidth  calculation 

testMsg ( "qosArray [ "  +  bSL  +  "]. setUtilization ( "  +  utilization  +  ")") 

//  Set  flag  to  display  warning  message 
if((bSL  ==  INT_SERV) | | (bSL  ==  DIFF_SERV)) 

{ 

isUtilizationChangedForlSorDS  =  true; 

} 


} 

break; 

case  ServiceSA. DELAY  TYPE; 
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//delay  update 


short  oldDelay  =  qosArray [bSL] . getDelay ( ) ; 
short  delay  =  thisServiceLevelSA. getDelay () ; 
short  delayVariation  =  (short) (delay  -  oldDelay) ; 

if (Math . abs (delayVariation)  >=  thresholdDelay) 

{ 

//Delay  has  changed  significantly  -  must  update 
isInterfaceChanged  =  true; 

qosArray [bSL] . setDelay (delay) ; 

testMsg ( "qosArray [ "  +  bSL  +  "]. setDelay ( "  +  delay  +  ")  delta  =  "  + 
delayVariation) ; 

//Keep  track  of  changes  for  the  path  delay  update 
deltaDelay [bSL]  =  delayVariation; 

) 

break; 

case  ServiceSA. LOSSRATE_TYPE ;  //loss  rate  update 

short  oldLossRate  =  qosArray [bSL]  . getLossRate ()  ; 

short  lossRate  =  thisServiceLevelSA. getLossRate () ; 

short  lossRateVariation  =  (short) (lossRate  -  oldLossRate) ; 

if (Math.abs (lossRateVariation)  >=  thresholdLossRate) 

{ 

//Loss  Rate  has  changed  significantly  -  must  update 
IsInterfaceChanged  =  true; 

qosArray [bSL] . setLossRate (lossRate) ; 

//Keep  track  of  changes  for  the  path  loss  rate  update 
deltaLossRate [bSL]  =  lossRateVariation; 

testMsg ( "qosArray [ "  +  bSL  +  "]. setLossRate ( "  +  lossRate  + 

")  delta  =  "  +  lossRateVariation); 


break; 

default:  //unsupported  metric 

display. sendText ( 

" [Updateinterface]  Unsupported  metric  type:  "  +  metricType) ; 

}//end  of  switch 

}//end  of  for-loop  through  each  SSA 

//Now  all  SSAs  are  processed,  if  the  interface  has  actually  changed, 

//must  evaluate  available  bandwidth  for  each  SL 

//If  the  interface  did  not  change,  no  more  work  to  do 
if ( ! IsInterfaceChanged) 

{ 

testMsg (" Interface  did  not  change,  after  processing  all  SSA  of  this  ISA"); 
return; 

} 


if ( IsUtilizationChangedFor ISorDS ) 

{ 

//  An  ISA  was  received  for  updating  utilization  of  IntServ  or  DiffServ. 

//  Must  not  propagate  interface  utilization  until  utilization  report 
//  contains  realistic  information, 
display. sendText  ( 

"PIB  RESOURCE  MANAGEMENT  WARNING: \n"  + 

"An  ISA  changed  utilization  of  IntServ  or  DiffServ  of  an  Interface . \n"  + 
"PIB  reservation  mechanism  may  not  functionally  correctly  if  routersXn"  + 
"advertise  inaccurate  link  utilization.  As  of  Sep  2001,  Link  \n"  + 

"State  Monitor  was  not  adverting  correct  utilization .\n"); 
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//Refresh  the  interface  QoS  parameters 
ref reshinterf aceQoS (interfaceinformation) ; 

//Now  the  interface  has  been  updated,  must  update  the  QoS  parameters  of 
//all  paths  transversing  this  interface 

Hashtable  pathIDs  =  interfaceinformation . getPathIDs () ; 

Enumeration  enumPathIDs  =  pathIDs . elements () ; 

testMsg ( "Update  paths  transversing  changed  interface"); 

while  (  enumPathIDs .hasMoreElements ( )  ) 

{ 

Integer  nextPathID  =  (Integer)  enumPathIDs . nextElement () ; 

Path  thisPath  =  (Path)  htPaths , get (nextPathID) ; 

ref reshPathQoS (thisPath,  deltaDelay,  deltaLossRate ) ; 

}  //  end  while-loop  through  all  paths 

display . sendText ( "Finished  updating  interface!"); 

}  //  End  of  0 


//[PS]  -  created  to  support  inter-service  borrowing 
/  *  * 

*  Refreshes  the  interface  QoS  data,  after  processing  one  or  more  LSAs  which 

*  incurred  an  interface  change.  This  method  gets  also  called  from 

*  Interfaceinfo  constructor  and  from  the  interface  resetQoS  method. 

*  @param  interfacelO  the  Interfaceinfo  object. 

*  @return  void. 

*/ 

protected  void  ref reshInterfaceQoS ( Interfaceinfo  interfacelO) 

{ 

testMsg ( "ref reshInterfaceQoS ( ) " ) ; 

//  Interface  bandwidth 

int  totalBandwidth  =  interfacelO. getTotalBandwidth () ; 

//  Interface  QoS  information 

ObsQoS[]  qosArray  =  interfacelO . getQoS () ; 

//Determine  the  portion  on  the  total  bandwidth  currently  not  allocated 

int  unallocatedBandwidth  =  totalBandwidth; 

int  baseUnallocatedBW  =  totalBandwidth; 

for (byte  si  =  0;  si  <  NUM_OF_SERVICE_LEVELS  -  1;  sl++) 

{ 

int  slBaseAllocation  = 

(int)  (  (float) totalBandwidth  *  afBASE_ALLOCATION [ si ] ) ; 

baseUnallocatedBW  -=  slBaseAllocation; 

int  slInUseBandwidth  =  (int)  ( 

(double) totalBandwidth  * 

(double) qosArray [si] . getUtilization ( )  *  ServiceSA.UTIL_UNIT 

)  ; 

switch (si) 

{ 

case  INT_SERV:  //Special  case  (IS)  -  may  grow  dynamically 

case  DIFF_SERV:  //Special  case  (DS)  -  may  grow  dynamically 

unallocatedBandwidth  -=  Math. max (slBaseAllocation, slInUseBandwidth) ; 
break; 

default : 

unallocatedBandwidth  -=  slBaseAllocation; 
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}//end  of  switch 


}//end  of  for-loop  for  determining  unallocated  bandwidth 

//Ensures  unallocated  BW  is  not  negative  (case  with  inter-service  borrowing) 
unallocatedBandwidth  =  Math. max (0,  unallocatedBandwidth); 

interface 10 . setUnallocatedBandwidth (unallocatedBandwidth) ; 

testMsg ( "interf acelO . setUnallocatedBandwidth (  "+unallocatedBandwidth  +"  )"); 

int  borrowingIS  =  0; 
int  borrowingDS  =  0; 

//Determine  and  set  the  available  bandwidth  for  each  service  level 
for (byte  si  =  0;  si  <  NUM_OF_SERVICE_LEVELS  -  1;  sl++) 

{ 

//  The  initial  base  allocation 
int  slBaseAllocation  = 

(int)  (  (float) totalBandwidth  *  afBASE_ALLOCATION [ si ]  ); 

//  The  initial  base  allocation  affected  by  the  SL  load  factor 
int  slTrueBaseAllocation  =  (int) ( 

(float) slBaseAllocation  *  afLOAD_FACTOR[sl] ) ; 

//  The  current  total  service  level  allocation 
int  slInUseBandwidth  =  (int)  ( 

(double) totalBandwidth  * 

(double) qosArray [si] , getUtilization ( )  *  ServiceSA,UTIL_UNIT) ; 

int  slAvailableBandwidth; 
int  stepl  =  0; 
int  step2  =  0; 
int  Steps  =  0; 

//Differentiate  for  special  cases 
switch (si) 

{ 

case  INT_SERV:  //Special  case  (IS)  -  may  grow  dynamically 

stepl  =  Math. max (0, slTrueBaseAllocation  -  slInUseBandwidth); 

Steps  =  unallocatedBandwidth; 

Steps  =  Math. max (0, slInUseBandwidth 

-  baseUnallocatedBW  -  slTrueBaseAllocation) ; 
slAvailableBandwidth  =  stepl  +  step2  -  stepS; 

testMsg ( "step  1  +  2  +  S  :  "  +  stepl  +  "  +  "  +  step2  +  "  +  "  +  stepS) ; 
borrowingIS  =  Math. abs (Math. min (0, slAvailableBandwidth) ) ; 
break; 

case  DIFF_SERV:  //Special  case  (DS)  -  may  grow  dynamically 

stepl  =  Math. max (0, slTrueBaseAllocation  -  slInUseBandwidth); 

Steps  =  unallocatedBandwidth; 

Steps  =  Math. max (0, slInUseBandwidth 

-  baseUnallocatedBW  -  slTrueBaseAllocation) ; 
slAvailableBandwidth  =  stepl  +  steps  -  stepS; 

testMsg ( "step  1  +  2  +  S  :  "  +  stepl  +  "  +  "  +  steps  +  "  +  "  +  stepS); 
borrowingDS  =  Math. abs (Math. min (0, slAvailableBandwidth) ) ; 
break; 

default:  //All  other  cases  (BE,  CC  and  OP) 

slAvailableBandwidth  =  slTrueBaseAllocation  -  slInUseBandwidth; 

}  //  end  switch 

//  set  the  new  value  of  available  bandwidth 
interf ace 10 . setServiceLevelAvailableBandwidth ( 
slAvailableBandwidth,  si) ; 

testMsg ( "interf acelO . setServiceLevelAvailableBandwidth (  "  + 
slAvailableBandwidth  +  "  ,  "  +  si  +"  )  "  )  ; 

//Determine  and  set  the  new  borrowing  capacity  for  this  Service  Level 
interf ace 10 . setServiceLevelBorrowingCapacity ( 

borrowingCapacity (slBaseAllocation,  slInUseBandwidth,  si),  si); 
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}//end  of  for-loop  through  each  service  level  for  setting  available  BW 

//Correct  available  bandwidth  if  borrowing  is  taking  place  -  IS 
if (borrowingIS  >  0) 

{ 

int  newSLAvBW  = 

interfacelO.getServiceLevelAvailableBandwidth (DIFF_SERV)  -  borrowingIS; 
interfacelO. setServiceLevelAvailableBandwidth (newSLAvBW,  DIFF_SERV) ; 

} 

//Correct  available  bandwidth  if  borrowing  is  taking  place  -  IS 
if (borrowingDS  >  0) 

{ 

int  newSLAvBW  =  interfacelO . getServiceLevelAvailableBandwidth ( INT_SERV) 

-  borrowingDS; 

interfacelO. setServiceLevelAvailableBandwidth (newSLAvBW,  INT_SERV) ; 

} 

}  //end  of  ref reshInterfaceQoS ( ) 

//[PS]  -  added  to  support  inter-service  borrowing 
/  *  * 

*  Refreshes  the  interface  bandwidth,  after  admiting  a  new  flow  to  a  path 

*  passing  through  this  interface. 

*  @param  interfacelO  the  interface. 

*  @param  bandwidthReduction  the  bandwidth  assigned  to  the  flow  just  admited. 

*  @param  bSL  the  service  level  the  bandwidth  changes  applies  to. 

*  @return  void. 

*/ 

protected  void  ref reshInterfaceBW ( 

Interfaceinfo  interfacelO, 
int  bandwidthReduction, 
byte  bSL) 

{ 

testMsg ( "ref reshInterfaceBW ( "  +  bandwidthReduction  +  + 

bSL  +  ") ") ; 

int  oldSLBandwidth; 

int  newSLAvailableBW  =  0; 

//  For  service  levels  other  than  those  where  Dynamic  Growing  and  Interservice 
//  borrowing  is  allowed  (IntServ  and  DiffServ) ,  simply  reduce  the  available 
//  bandwidth  by  the  amount  requested 
if(bSL  !=  INT_SERV  &&  bSL  !=  DIFF_SERV) 

{ 

oldSLBandwidth  =  interfacelO. getServiceLevelAvailableBandwidth (bSL) ; 
interfacelO . setServiceLevelAvailableBandwidth ( 
oldSLBandwidth  -  bSL,  bSL) ; 
return; 

} 


//  Cases  of  IntServ  or  DiffServ  (Dynamic  Growing  and  Interservice  Borrowing) 

int  oldUnallocatedBW  =  interfacelO. getUnallocatedBandwidth () ; 

int  oldSLAvailableBW  =  interfacelO. getServiceLevelAvailableBandwidth (bSL) ; 

newSLAvailableBW  =  oldSLAvailableBW  -  bandwidthReduction; 

//  Set  the  new  service  level  available  bandwidth 

interfacelO. setServiceLevelAvailableBandwidth (newSLAvailableBW,  bSL) ; 

testMsg ( "iFacelO . setServiceLevelAvBW ( "  +  newSLAvailableBW+" , "  +  bSL  +  ")"); 

//  Service  level  base  allocation  (initial  allocated  capacity) 
int  baseAllocation  = 

(int) (afBASE_ALLOCATION [bSL]  *  ( float ) interface 10 . getTotalBandwidth ()) ; 

if (newSLAvailableBW  >  oldUnallocatedBW) 

{ 

//  Step  1  -  direct  admission  (unallocated  space  was  not  yet  required) 

//  Determine  and  set  the  new  borrowing  capacity 

//  To  calculate  the  new  borrowing  capacity,  it  is  necessary  to  first 
//  determine  the  SL  base  allocation  and  current  utilization 
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int  currentBWUtilization  = 

baseAllocation  - (newSLAvailableBW  -  oldUnallocatedBW) ; 

int  be  =  borrowingCapacity (baseAllocation,  currentBWUtilization,  bSL) ; 
interfacelO. setServiceLevelBorrowingCapacity (be,  bSL) ; 
testMsg ( "Phase  1  (Direct  Admission):  "  + 

" I Face , setServiceLevelBC ( "+bc+" , "+bSL+" ) " ) ; 

} 

else 

{ 

//  Step  2  -  dynamic  growing  (unallocated  bandwidth  has  been  claimed)  or 
//  Step  3  -  interservice  borrowing 

//  Determine  and  set  the  new  unallocated  bandwidth 

int  newUnallocatedBW  =  Math .max (0 , oldSLAvailableBW  -  bandwidthReduction) 
interfacelO. setUnallocatedBandwidth (newUnallocatedBW) ; 
testMsg ( "Phase  2/3  (Dynamic  growing/borrowing)  "  + 

" IFace . setUnallocatedBW ( , "  +  newUnallocatedBW  +  ")"); 

//  Set  the  SL  borrowing  capacity  to  0  (zero) 
interfacelO . setServiceLevelBorrowingCapacity ( 0 ,  bSL) ; 
testMsg ( "Phase  2/3  (Dynamic  growing/borrowing)  "  + 

"IFace . setServiceLevelBC (0 , "  +  bSL  +  ")"); 

//  Reduce  the  available  BW  for  the  other  dynamic  SL  by  the  delta  UA 
int  deltaUA  =  oldUnallocatedBW  -  newUnallocatedBW; 
int  oldAvBW; 
switch (bSL) 

{ 

case  INT_SERV: 

oldAvBW  =  interfacelO. getServiceLevelAvailableBandwidth (DIFF_SERV) ; 
interfacelO . setServiceLevelAvailableBandwidth ( 

OldAvBW  -  deltaUA,  DIFF_SERV) ; 

testMsg ( "Phase  2/3  (Dynamic  growing/borrowing)  "  + 

" IFace . setServiceLevelAvBW ( "  +  (oldAvBW  -  deltaUA) + 

","  +  DIFF_SERV  +  ")"); 
break; 

case  DIFF_SERV: 

oldAvBW  =  interfacelO. getServiceLevelAvailableBandwidth (INT_SERV) ; 
interfacelO . setServiceLevelAvailableBandwidth ( 

OldAvBW  -  deltaUA,  INT_SERV) ; 

testMsg ( "Phase  2/3  (Dynamic  growing/borrowing)  "  + 

" IFace . setServiceLevelAvBW ( "  +  (oldAvBW  -  deltaUA)  +  ","  + 
INT_SERV  +  ")"); 

break; 

} 

} 

}  //  end  of  ref reshinterf aceBW ( ) 

/  *  * 

*  Refreshes  the  QoS  information  of  a  given  path.  Whenever  a  path  is  newly 

*  created,  or  a  changed  in  one  or  more  of  its  interfaces  happens,  the 

*  path  QoS  need  to  be  refreshed  so  that  the  path  QoS  information  takes 

*  those  changes  into  account. 

*  @param  path  the  Path  to  update. 

*  @return  void 
*/ 

protected  void  refreshPathQoS (Path  path) 

{ 

testMsg ( "refreshPathQoS ( "+path . getPathID ()+")") ; 

PathQoS  pathQoS[]  =  path . getPathQoSArray ( ) ; 

short [] []  delayAndLossRateArray  =  findPathDelayAndLossRate (path) ; 
int[] []  pathAvailableBW  =  pathBandwidth (path) ; 

//For  every  Service  Level,  check  the  QoS  attributes  of  this  Path 
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for (byte  si  =  0;  si  <  NUM_OF_SERVICE_LEVELS  -  1;  sl++) 

{ 

//Set  path  QoS  parameters 

pathQoS[sl] . setAvailableBandwidth (pathAvailableBW [ 0 ]  [si]); 

pathQoS [ si 1 . setAvailableBandwidth I ncludingBor rowing (pathAvailableBW [ 1 ] [ si ] ) 
pathQoS [si] . set Delay (delayAndLossRateArray [0 ]  [si] )  ; 
pathQoS [si] . setLossRate (delayAndLossRateArray [ 1 ] [si] ) ; 

}//end  for-loop  through  all  service  levels 

}  //end  of  ref reshPathQoS ( ) 

//  [PS]  -  created  to  support  sinter-service  borrowing 
/  *  * 

*  Refreshes  the  QoS  information  of  a  given  path. 

*  @param  path  the  path  to  update. 

*  @param  deltaDelay[]  an  array  with  the  delay  variations  per  Service  Level. 

*  @param  deltaLossRate [ ]  an  array  with  the  loss  rate  variations  per  SLevel. 

*  @return  void. 

*/ 

protected  void  ref reshPathQoS ( 

Path  path, 

short  []  deltaDelay, 

short  []  deltaLossRate) 

{ 

testMsg ( "ref reshPathQoS ( "  +  path . getPathID ( ) . toString ( )  +  ")"); 

PathQoS  pathQoS []  =  path . getPathQoSArray ( ) ; 
int[] []  pathAvailableBW  =  pathBandwidth (path) ; 

//For  every  Service  Level,  check  the  QoS  attributes  of  this  Path 
for (byte  si  =  0;  si  <  NUM_OF_SERVICE_LEVELS  -  1;  sl++) 

{ 

//Set  path  QoS  parameters 

pathQoS [si] . setAvailableBandwidth (pathAvailableBW [ 0 ]  [si]); 

pathQoS [ si ] . setAvailableBandwidth I ncludingBor rowing (pathAvailableBW [ 1 ] [ si ] ) 
pathQoS [si] .updatePathDelay (deltaDelay [si] ) ; 
pathQoS [si] .updatePathLossRate (deltaLossRate [si] ) ; 

}//end  for-loop  through  all  service  levels 

}  //  end  of  refreshPathQoS (Path,  dDelay,  dLR) 

//[PS]  -  created  to  support  inter-service  borrowing 
y  *  * 

*  Calculates  the  bandwidth  capacity  that  might  be  released  for  inter-service 

*  borrowing  by  the  specified  service  level. 

*  @param  bandwidth  an  integer  representing  the  bandwidth  allocation  for 

*  the  service  level  (base  allocation  affected  by  the  load  factor) . 

*  @param  utilization  the  current  absolute  utilization. 

*  @bSL  si  service  level. 

*  @return  an  integer  greater  or  equal  to  zero,  with  the  amount  of  bandwidth 

*  that  the  specified  service  can  make  available  for  borrowing. 

*/ 

protected  int  borrowingCapacity (int  bandwidth,  int  utilization,  byte  bSL) 

{ 

int  borrowingCapacity  =  0; 

if(bSL  ==  DIFF_SERV  ||  bSL  ==  INT_SERV) 

{ 

//  This  applies  the  formula  of  inter-service  borrowing  and  ensures 
//  that  bandwidth  bellow  the  given  threshold  is  never  made  available 
//  for  borrowing. 

//  X  =  sumation(Rf)  +  offset  *  sumation(Rf) 

//  where  x  is  the  amount  of  bandwidth  that  cannot  be  borrowed. 
borrowingCapacity  =  Math. round ( 

afLOAD_FACTOR [bSL]  *  (float) (bandwidth  -  Math. max ( 

(float) bandwidth  *  borrowingThreshold, 

(float) utilization  *  (l.Of  +  BORROWING_PROBABILITY_OFFSET) ) ) ) ; 

//  For  high  levels  of  utilization  or  poor  settings  of  the  off  set  factor. 
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//  it  must  be  ensured  the  formula  does  not  yield  a  negative  result 
borrowingCapacity  =  Math. max (0,  borrowingCapacity) ; 


return  borrowingCapacity; 

} 


//[PS]  -  created  to  support  inter-service  borrowing 
y  *  * 

*  Searches  all  interfaces  traversed  by  a  given  path  for  the  minimum 

*  available  bandwidth  of  a  specified  service  level.  Both  values  of 

*  availability,  with  and  without  inter-service  borrowing,  are  calculated  and 

*  then  returned  as  an  array  of  size  2. 

*  @param  path  the  given  path. 

*  @param  bSL  the  given  service  level. 

*  @return  int[]  an  integer  array  of  size  2,  containing  respectively 

*  the  minimum  available  bandwidth  without  inter-service  borrowing  and  the 

*  minimum  available  bandwidth  including  inter-service  borrowing. 

*/ 

protected  int[]  pathBandwidth (Path  path,  byte  bSL) 

{ 

//  Local  support  variables 
boolean  checkinterface; 
int  tempBW; 

//  Array  to  hold  the  result  for  return.  Initialized  with  'magic  numbers'. 

//  The  numbers  represent  the  an  upper  bound  for  the  minimum  available  BW 
int  []  minimumBW  =  {10000000,10000000}; 

Vector  interfaceSequence  =  path . getInterfaceSequence  ( ) ; 

Enumeration  e  =  interfaceSequence . elements () ; 

//  Step  through  all  interfaces  traversed  by  this  path 
while  (e . hasMoreElements ( ) ) 

{ 

IPvGAddress  address  =  (IPvOAddress)  e . nextElement ( ) ; 

Interfaceinfo  interfacelO  = 

( Interface Info)  ht Interfaces . get (address . toString ( ) ) ; 

//  Check  to  see  if  a  new  minimum  is  found 

tempBW  =  interfacelO. getServiceLevelAvailableBandwidth (bSL) ; 
if  (tempBW  <  minimumBW [ 0 ] ) 

{ 

//A  new  minimum  value  has  been  found 
minimumBW [0]  =  tempBW  ; 

} 


//  Check  to  see  if  a  new  minimum  including  borrowing  is  found 
switch (bSL) 

{ 

case  INT_SERV: 

tempBW  +=  interfacelO. getServiceLevelBorrowingCapacity (DIFF_SERV) ; 
break; 

case  DIFF_SERV: 

tempBW  +=  interfacelO. getServiceLevelBorrowingCapacity (INT_SERV) ; 
break; 

default : 

//  Do  nothing 

} 


if  (tempBW  <  minimumBW [ 1 ] ) 

{ 

//A  new  minimum  value  has  been  found  (including  interservice  borrowing 
minimumBW [1]  =  tempBW  ; 

} 

}//end  of  while  loop 
return  minimumBW; 
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}//end  of  findMinimumAvailableBandwidth (Path,  bSL) 


//[PS]  -  created  to  support  inter-service  borrowing 
/  *  * 

*  Searches  all  interfaces  transversed  by  a  given  path  for 

*  available  bandwidth,  both  with  and  without  interservice 

*  across  all  service  levels. 

*  @param  path  the  given  path. 

*  @return  int[] []  a  two-dimension  array  of  integers  where 

*  int[l]  [i]  refer  to  the  path  bandwidth  for  service  level 

*  with  interservice  borrowing,  respectively. 

*/ 

protected  int[][]  pathBandwidth (Path  path) 


the  minimum 
borrowing  and 


int [0] [i]  and 
' i ' ,  without  and 


//  Local  support  variables 
boolean  checkinterface; 
int  tempBW; 

int  [] []  minimumBW  =  new  int [ 2 ] [NUM_OF_SERVICE_LEVELS  -  1]; 


//  Array  to  hold  the  result  for  return.  Initialized  with  'magic  numbers'. 
//  The  numbers  represent  the  an  upper  bound  for  the  minimum  available  BW 
for (byte  si  =  0;  si  <  NUM_OF_SERVICE_LEVELS  -  1;  sl++) 


minimumBW[0] [si]  =  10000000; 
minimumBW[l] [si]  =  10000000; 


Vector  interfaceSequence  =  path . getInterfaceSequence ( ) ; 
Enumeration  e  =  interfaceSequence . elements () ; 

//  Ckeck  every  interface  of  the  path 
while  (e .hasMoreElements ( ) ) 

{ 

IPvGAddress  address  =  (IPv6Address)  e . nextElement ( ) ; 


Interfaceinfo  interfacelO  = 

( Interface Info)  ht Interfaces . get (address . toString ( ) ) ; 

//  For  this  interface,  repeat  process  for  every  service  level 
for (byte  bSL  =  0;  bSL  <  NUM_OF_SERVICE_LEVELS  -  1;  bSL++) 

{ 


//  Check  to  see  if  a  new  minimum  is  found 

tempBW  =  interfacelO. getServiceLevelAvailableBandwidth (bSL) ; 
if  (tempBW  <  minimumBW[0] [bSL] ) 

{ 

//A  new  minimum  value  has  been  found 
minimumBW[0] [bSL]  =  tempBW; 

} 


//  Check  to  see  if  a  new  minimum  including  borrowing  is  found 
switch (bSL) 

{ 

case  INT_SERV: 

tempBW  +=  interfacelO. getServiceLevelBorrowingCapacity (DIFF_SERV) ; 

break; 

case  DIFF_SERV: 

tempBW  +=  interfacelO. getServiceLevelBorrowingCapacity (INT_SERV) ; 

break; 

default : 

//  Do  nothing 
}  //  end  of  switch 


if  (tempBW  <  minimumBW[l] [bSL] ) 

{ 

//A  new  minimum  value  has  been  found  (including  interservice  borrowing 
minimumBW [1] [bSL]  =  tempBW; 
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}  //  end  of  the  for  loop  through  all  service  levels 
}//end  of  while  loop 
return  minimumBW; 

}//  end  of  pathBandwidth (Path) 

//[PS]  -  created  to  support  inter-service  borrowing 
y  *  * 

*  Visits  all  interfaces  transversed  by  a  path  to  compute  the  path 

*  delay  and  the  loss  rate  for  all  service  levels. 

*  @param  path  the  given  Path. 

*  @return  short  [] []  a  2-dimension  array  with  the  values  found,  where 

*  [0] [i]  refers  to  the  delay  of  service  level  i  and  [1] [i]  refers  to 

*  the  loss  rate  of  service  level  i. 

*/ 

protected  short[][]  findPathDelayAndLossRate (Path  path) 

{ 

//Local  support  variables 

short[][]  result  =  new  short [ 2 ] [NUM_OF_SERVICE_LEVELS  -  1]; 

Vector  interfaceSequence  =  path . getinterf aceSequence ( ) ; 

Enumeration  e  =  interf aceSequence . elements () ; 

//Cycle  through  all  interfaces  along  this  path 
while  (e .hasMoreElements ( ) ) 

{ 

IPv6Address  address  =  (IPv6Address)  e . nextElement ( ) ; 

Interfaceinfo  interfacelO  = 

( Inter face Info)  ht Inter faces . get (address . toString ( ) ) ; 

ObsQoS[]  qosArray  =  interf acelO . getQoS () ; 

for(int  1=0;  1  <  NUM_OF_SERVICE_LEVELS  -1;  i++) 

{ 

result[0][i]  +=  qosArray [ 1 ]. getDelay () ; 
result [l][i]  +=  qosArray [ 1 ]. getLossRate () ; 

} 

}//end  of  while  loop 
return  result; 

}//end  of  findPathDelayAndLossRate (path) 

// [PS]  -  created 
/  *  * 

*  Resets  all  QoS  dynamic  information  contained  in  PIB. 

*  @return  void. 

*/ 

private  void  resetQoSO 

{ 

testMsg ( "resetQoS ( ) " ) ; 
int  count  =  1; 

Enumeration  einterfaces  =  htinterf aces . elements () ; 
while (einterfaces .hasMoreElements ( ) ) 

{ 

Interfaceinfo  iface  =  ( Interfaceinfo) einterfaces . nextElement () ; 
testMsg ("\tlnterface  #  "  +  (count+i) ) ; 
iface . resetQoS  ( )  ; 

} 

}//end  of  resetQoSO 

//  [PS]  -  reviewd 
/  *  * 

*  Processes  a  new  flow  request.  This  method  is  only  used  by  the  PIB  tester. 

*  The  method  is  also  used  to  reset  the  pib  QoS  data. 

*  @param  flowRequest  the  new  FlowRequest.  If  null  is  passed,  pib  QoS  data  are 

*  reset. 
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*  @return  a  Vector  containing  the  list  of  interfaces  the  flow  will 

*  traverses  or  null  if  the  flow  cannot  be  admited. 

*/ 

public  Vector  processFlowRequest_test (FlowRequest  flowRequest) 

{ 

if ( flowRequest  ==  null) 

{ 

//Reset  pib  QoS  data  and  return  null 
resetQoS ( ) ; 
return  null; 

} 


vIFacesTraversed. clear ( ) ; 
processFlowRequest (flowRequest) ; 

//Must  return  the  routerlD  of  each  of  the  interfaces  traversed 

//The  return  vector  will  have  intercaleted,  interface  traversed  and  routerlD 

Enumeration  e  =  vIFacesTraversed . elements () ; 

Vector  vResult  =  new  Vector (); 
while (e . hasMoreElements ( ) ) 

{ 

//add  to  result  vector,  the  interface 

IPv6Address  IFaceAddress  =  ( IPv6Address) e . nextElement ( ) ; 
vResult. add (IFaceAddress) ; 

//add  to  result  vector,  the  routerlD  of  the  interface 
Interfaceinfo  ifinfo  = 

( Inter face Info) ht Inter faces . get (IFaceAddress . toString ( ) ) ; 

Integer  nodelD  =  if Info . getNodelD ( ) ; 

IPv6Address  routerlD  =  ( IPv6Address ) htNodelDtoRouter ID . get (nodelD) ; 
vResult. add (routerlD) ; 

//add  to  result  vectot,  the  interface  total  bandwidth 
vResult . add (new  Integer (ifinfo . getTotalBandwidth ( ) ) ) ; 

} 

return  ( (Vector) vResult . clone ( ) ) ; 


//[PS]  -  redesigned 
/  *  * 

*  Processes  a  new  flow  request. 

*  @param  flowRequest  the  new  FlowRequest. 

*  @return  an  integer  flow  label,  in  which  the  lower  16  bits  carry  path-id 

*  to  be  used  for  routing.  0  signifies  rejection  of  flow  request. 

*/ 

public  int  processFlowRequest ( FlowRequest  flowRequest) 

{ 

testMsg ( "processFlowRequest ( ) " )  ; 

display . sendText (" \nNew  flow  request  arrived  to  PIB"); 

int  serviceLevel ; 
int  flowLabel  =  0; 

//  Get  service  level 

serviceLevel  =  flowRequest . getServiceLevel () ; 

if  (htinterfaces  ==  null) 

{ 

//  PIB  is  not  ready  yet 

display . sendText ( "\tPIB  is  not  ready.  No  interfaces  are  defined!"); 

} 

else 

{ 

//  Select  appropriate 
switch (serviceLevel) 

{ 


case  INT_SERV: 

display . sendText (" \tService  Level  "  +  serviceLevel  +  ":  IntServ"); 
flowLabel  = 

admissionControl_IS (flowRequest) ; 
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break; 


case  DIFF_SERV: 

display . sendText (" \n\tService  Level  "  +  serviceLevel  +  DiffServ"); 
flowLabel  = 

admissionControl_DS (flowRequest) ; 
break; 

case  BEST_EFFORT: 

display . sendText (" \n\tService  Level  "  +  serviceLevelt" :  Best  Effort") 
flowLabel  = 

admissionControl_BE (flowRequest) ; 
break; 

default : 

display . sendText (" \n\tService  Level  "  +  serviceLevelt  Unsuported") 
flowLabel  =  0; 

}  //  End  of  switch 

}  //  end  of  if  PIB  not  ready 

return  flowLabel; 

}  //End  of  processFlowRequest 

//[PS]  -  redesigned 
/  *  * 

*  Checks  for  the  feasibility  of  a  given  source  node  to  reach  a  given 

*  destination  node,  i.e.,  whether  a  path  between  two  nodes  exists  in  the  PIB 

*  @param  sourceNodelD  the  source  node  ID. 

*  @param  destinationNodelD  the  destination  node  ID. 

*  @return  true  if  it  exists  a  path  between  the  given  nodes  and  false  if 

*  otherwise. 

*/ 

protected  boolean  isRouteFeasible (int  sourceNodelD,  int  destinationNodelD) 

{ 

//determine  whether  the  source  node  can  reach  the  destination  node 
for  (int  i  =  1;  i  <  MAX_H0P_C0UNT  ;  i++) 

{ 

if  (aPI [sourceNodelD] [destinationNodelD] [i]  !=  null) 

{ 

return  true; 

} 

}//End  of  for-loop 
return  false; 

}  //End  of  isRouteFeasible ( ) 

//[PS]  -  redesigned 
/  *  * 

*  Updates  the  remaining  available  bandwidth  of  a  given  path  after  admiting 

*  a  new  flow. 

*  @param  currentPath  the  path  to  update. 

*  @param  requestedBandwidth  the  requested  bandwidth. 

*  @param  bSL  the  given  service  level. 

*  @return  void. 

*/ 

protected  void  updateAvailableBandwidth ( 

Path  currentPath, 

int  requestedBandwidth, 

byte  bSL) 

{ 

HashSet  changedPaths  =  new  HashSetO; 

Integer  currentPathID  =  currentPath.getPathIDO; 

testMsg ( "updateAvailableBW ( "  +  currentPathID  +  +  requestedBandwidth  + 

"  +  bSL  +  ") ") ; 

testMsg ( "Loop  through  all  iFaces  of  path"  +  currentPathID); 

//  Change  available  bandwidth  of  every  interface  traversed  by 
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//  this  path  (outbound  interfaces) . 

Enumeration  einterface  =  currentPath . getInterfaceSequence (). elements () ; 

while  (einterface .hasMoreElements () ) 

{ 

//  Retrieve  next  interface 

IPvGAddress  iFaceAddress  =  (IPvGAddress)  einterface . nextElement () ; 
Interfaceinfo  interfacelO  = 

( Interface Info)  ht Interfaces . get (iFaceAddress . toString ( ) ) ; 

//  If  in  test  mode,  add  this  interface  to  the  list  of  interfaces  this 
//  new  flow  traverses 

if (TESTING_MODE) 

{ 

vIFacesTraversed.add (iFaceAddress) ; 

} 

//  Update  interface  BW  to  reflect  the  BW  reduction  in  one  service  level. 

//  Due  to  interservice  borrowing,  it  may  also  affect  other  services  BW 
refreshInterfaceBW (interfacelO,  requestedBandwidth,  bSL) ; 

//  Must  update  all  paths  that  traverse  this  interface,  outbound  direction 
//  For  now,  I  will  only  flag  those  paths.  When  done  with  all  interfaces 
//  associated  with  the  path  that  admited  the  new  flow,  then  we  will 
//  refresh  all  flaged  paths 

Hashtable  pathIDs  =  interfacelO. getPathIDs () ; 

Enumeration  enumPathIDs  =  pathIDs . elements () ; 

//  Step  through  all  paths  that  traverse  this  interface 
while  (enumPathIDs .hasMoreElements ( ) ) 

{ 

//  Add  the  path  ID  (Integer)  to  the  set  paths  that  need  to  be  updated 
changedPaths . add (enumPathIDs . nextElement ( ) ) ; 

}  //  end  of  while  loop  through  all  paths 

}  //  end  of  while  loop  through  the  interface  sequence  of  a  path 

//  Now  all  interfaces  traversed  by  this  path  have  been  updates,  lets  refresh 
//  all  afected  paths,  so  that  they  reflec  the  interface  changes 
Iterator  pathIDs  =  changedPaths . iterator () ; 
while (pathIDs .hasNext ( ) ) 

{ 

//  Get  next  path 

Integer  pathID  =  ( Integer ) pathIDs . next () ; 

Path  thisPath  =  (Path)  htPaths . get (pathID) ; 
testMsg ( "Ref reshing  path  ID  "  +  pathID); 

//  Retrieve  path  QoS  array 

PathQoS[]  qos  =  thisPath . getPathQoSArray () ; 

//  Determine  and  set  the  new  path  avaliable  bandwidth  for  this  SL 
int[]  minAvailableBW  =  pathBandwidth (thisPath,  bSL) ; 
qos [bSL] . setAvailableBandwidth (minAvailableBW [ 0 ] ) ; 

qos [bSL] . setAvailableBandwidthIncludingBorrowing (minAvailableBW [ 1 ] ) ; 

//  For  service  levels  with  interservice  borrowing,  must  also 
//  determine  and  set  any  changes  in  their  respective  available  BW 

switch (bSL) 

{ 

case  INT_SERV: 

minAvailableBW  =  pathBandwidth (thisPath,  DIFF_SERV) ; 
qos [ DIFF_SERV] . setAvailableBandwidth (minAvailableBW [ 0 ] ) ; 
qos [DIFF_SERV] . setAvailableBandwidthIncludingBorrowing ( 
minAvailableBW [ 1 ] ) ; 
break; 

case  DIFF_SERV: 

minAvailableBW  =  pathBandwidth (thisPath,  DIFF_SERV) ; 
qos [ INT_SERV] . setAvailableBandwidth (minAvailableBW [ 0 ] ) ; 
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qos [ INT_SERV] . setAvailableBandwidthIncludingBorrowing ( 
minAvailableBW [ 1 ] ) ; 
break; 

default : 

//  Do  nothing  if  any  other  service  level 
}  //  end  switch 

}  //  End  of  while  loop  through  all  paths 
}  //  End  of  updateAvailableBandwidth ( ) 


//[PS]  -  redesiged 
/  *  * 

*  Performs  the  admission  control  sequence  for  a  new  IntServ  flow  request. 

*  @param  flowRequest  the  new  flow  request  object. 

*  @return  the  flow  label  of  the  new  flow.  0  if  the  flow  is  rejected. 

*/ 

protected  int  admissionControl_IS (FlowRequest  flowRequest) 

{ 

testMsg ( "admissionControl_IS ( ) " ) ; 

int  flowLabel  =  0; 
int  flowID; 

FlowResponse  response; 

//  Retrieve  flow  request  data 

IPv6Address  sourceRouterlD  =  flowRequest . getSourceRouterlD () ; 

IPv6Address  destinationRouterlD  =  flowRequest . getDestinationRouterlD () ; 

long  timestamp  =  flowRequest . getTimeStamp () ; 

int  requestedBandwidth  =  flowRequest . getRequestedBandwidth  () ; 

short  requestedDelay  =  flowRequest . getRequestedDelay () ; 

short  requestedLossRate  =  flowRequest . getRequestedLossRate () ; 

//  Obtain  nodelDs  (int)  from  the  RouterlDs  ( IPv6Address ) 
int  sourceNodelD  =  ( ( Interfaceinfo) htinterfaces . get ( 
sourceRouterlD. toSt ring ( ) ) ) . getNodelD ( ) . intValue ( ) ; 
int  destinationNodelD  =  (( Interfaceinfo) htinterfaces . get ( 
destinationRouterlD. toSt ring ( ) ) ) . getNodelD ( ) . intValue ( ) ; 

//  Display  flow  request  data 
display. sendText ( 

"\tFlow  requirement  inf ormation : \n"  + 

"\t  Source  node:  \t"  +  sourceNodelD  +  "\n"  + 

"\t  Destination  node:\t"  +  destinationNodelD!  "\n"  + 

"\t  Bandwidth:  \t"  +  requestedBandwidth  +  "\n"  + 

"\t  Delay  bound:  \t"  +  requestedDelay  +  "\n"  + 

"\t  Loss  rate  bound:  \t"  +  requestedLossRate) ; 

if (  ! isRouteFeasible (sourceNodelD,  destinationNodelD)  ) 

{ 

//  Destination  is  not  reachable  from  source 

display . sendText ( "XtDestination  is  not  reachable  from  source"); 

//  Generate  negative  response 

response  =  new  FlowResponse (timeStamp,  FlowResponse. RE JECTED) ; 

} 

else 

{ 

//  Route  is  feasable 

display . sendText ( "\tRoute  is  feasible"); 

//  Call  routing  algorithm  to  select  the  appropriate  path 

Path  currentPath  =  routingAlgorithm. f indPath ( 
sourceRouterlD, 
destinationRouterlD, 
requestedBandwidth, 
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requestedDelay, 

requestedLossRate, 

INT_SERV, 

isBorrowingEnabled, 

RoutingAlgorithm. FIRST_SHORTEST_PATH) ; 
if  (currentPath  !=  null) 

{ 

//  A  path  exists  to  accomodate  this  flow  request 

//  Update  affected  path  and  interfaces  after  flow  admission 
updateAvailableBandwidth (currentPath,  requestedBandwidth,  INT_SERV) ; 

Integer  currentPathID  =  currentPath . getPathID () ; 

//  assign  a  flow  label  to  the  new  connection; 

//  flow  label  =  I  flow-id  (8bits)  I  path-id  (12bits) I 
flowID  =  currentPath . getNewFlowID 0 ; 

flowLabel  =  flowID  *  4096  +  currentPathID. intValue () ;  //  2^12  =  4096 
display. sendText  ( 

"\tFlow  id  \t=  "  +  flowID  +  "\n"  + 

"\tPath  id  \t=  "  +  CurrentPathID. intValue ( )  +  "\n"  + 

"\tFlow  Label  \t=  "  +  flowLabel) ; 

//Add  this  flow  into  the  ahtFlows  object  in  case  rerouting  is  needed  later 

currentPath .AddFlow ( 

INT_SERV,  flowLabel,  new  FlowQoS ( 

timestamp, 
requestedBandwidth, 
requestedDelay, 
requestedLossRate) ) ; 

//  Send  RoutingTableUpdates  to  routers  if  path  has  not  yet  been  created, 
if  (! currentPath. bCreated) 

{ 

setupPath (currentPath,  currentPathID. intValue ( ) ) ; 
currentPath. bCreated  =  true; 

} 


//  Generate  flow  response  and  send  it  to  the  sender 
response  = 

new  FlowResponse (timestamp,  FlowResponse . IS_ACCEPTED,  flowLabel); 

} 

else 

{ 

//  No  path  exist  that  can  accomodate  this  flow  request 
display. sendText  ( 

"\tThere  is  no  path  which  can  support  this  flow  request"); 

//  Generate  flow  response  and  send  it  to  the  sender 
response  =  new  FlowResponse (timeStamp,  FlowResponse. RE JECTED) ; 

}  //  end  if  path  created 

}  //  end  of  if  rounteFeasable 

//  Send  response  back  to  originator 

myServer . sendFlowResponse (response,  sourceRouterlD) ; 
return  flowLabel; 

}  //  End  of  admissionControl_IS ( ) 

/  *  * 

*  Performs  the  admission  control  sequence  for  a  new  DiffServ  flow  request. 

*  @param  FlowRequest  flowRequest. 

*  @return  the  flow  label  of  the  new  flow.  0  if  the  flow  is  rejected. 

*/ 

protected  int  admissionControl_DS (FlowRequest  flowRequest) 
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testMsg ( "admissionControl_DS ( ) " ) ; 

int  flowLabel  =  0; 

FlowResponse  response  =  null; 

//  Validate  user  requesting  the  flow 

//  Get  user  ID 

int  userlD  =  f lowRequest . getUserlD ( ) ; 

//  Get  the  Service  Level  Specification 

SLS  userSLS  =  (SLS)  htUserSLSs . get (new  Integer (userlD) ) ; 

//  Get  flow  request  data 

IPv6Address  sourceRouterlD  =  f lowRequest . getSourceRouterlD () ; 

IPv6Address  destinationRouterlD  =  f lowRequest . getDestinationRouterlD () ; 
long  timestamp  =  f lowRequest . getTimeStamp () ; 

//  Obtain  nodelDs  (int)  from  the  RouterlDs  ( IPv6Address ) 
int  sourceNodelD  =  ( ( Interfaceinfo) htinterfaces . get ( 
sourceRouterlD. toSt ring ( ) ) ) . getNodelD ( ) . intValue ( ) ; 
int  destinationNodelD  =  (( Interfaceinfo) htinterfaces . get ( 
destinationRouterlD. toSt ring ( ) ) ) . getNodelD ( ) . intValue ( ) ; 

//  Check  to  see  if  the  requestor  is  a  valid  customer 
if  (userSLS  ==  null) 

{ 

//  Not  a  valid  customer 

display . sendText ( "DS  request  is  from  an  invalid  customer.  Discarding ... \n" 

} 

else 

{ 

//  Valid  customer 

//  Get  the  QoS  parameter  of  this  user 
int  requestedBandwidth  =  userSLS . getProfile  () ; 
short  requestedDelay  =  userSLS . getDelay () ; 
short  requestedLossRate  =  userSLS . getDelay () ; 

display. sendText  ( 

"\tFlow  requirement  information  for  DiffServ:\n"  + 


\t 

Customer  ID: 

\t" 

+ 

userlD  +  "\n"  + 

\t 

Source  node: 

\t' 

'  +  sourceNodelD  +  "\n" 

\t 

Destination  node 

:\t' 

'  +  destinationNodeID+ 

\t 

SLS  bandwidth: 

\t" 

+ 

requestedBandwidth  + 

\t 

SLS  delay  bound: 

\t" 

+ 

requestedDelay  +  "\n 

\t 

SLS  loss  rate: 

\t" 

+ 

requestedLossRate)  ; 

if (  ! isRouteFeasible (sourceNodelD,  destinationNodelD)  ) 

{ 

//  Destination  is  not  reachable  from  source 

display . sendText ( "XtDestination  is  not  reachable  from  source"); 

//  Generate  negative  response 

response  =  new  FlowResponse (timeStamp,  FlowResponse .REJECTED) ; 

} 

else 

{ 

//  Route  is  feasable 

display . sendText ( "\tRoute  is  feasible"); 

//  Call  routing  algorithm  to  select  the  appropriate  path 

Path  currentPath  =  routingAlgorithm. f indPath ( 
sourceRouterlD, 
destinationRouterlD, 
requestedBandwidth, 
requestedDelay, 
requestedLossRate, 

DIFF_SERV, 
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isBorrowingEnabled, 

RoutingAlgorithm. FIRST_SHORTEST_PATH) ; 

if  (currentPath  !=  null) 

{ 

//  A  path  exists  to  accomodate  this  flow  request 

updateAvailableBandwidth (currentPath,  requestedBandwidth,  DIFF_SERV) ; 

Integer  currentPathID  =  currentPath . getPathID () ; 

//  Assign  a  flow  label  to  the  new  connection; 

//  Flow  label  =  I  flow-id  I  path-id  I ; 

//  in  this  case,  flow-id  =  0. 
flowLabel  =  currentPathID. intValue () ; 

display. sendText  ( 

"\tPath  id  \t=  "  +  CurrentPathID. intValue ( )  +  "\n"  + 

"\tFlow  Label  \t=  "  +  flowLabel) ; 

//Add  this  flow  into  the  ahtFlows  object 
FlowQoS  flowQoS  =  new  FlowQoS ( 
timestamp, 
requestedBandwidth, 
requestedDelay, 
requestedLossRate) ; 

currentPath .AddFlow ( 

DIFF_SERV,  flowLabel,  new  FlowQoS ( 

timestamp, 
requestedBandwidth, 
requestedDelay, 
requestedLossRate) ) ; 

//  Send  RoutingTableUpdates  to  routers  if  path  has  not  been  created, 
if  (! currentPath. bCreated) 

{ 

setupPath (currentPath,  currentPathID. intValue ( ) ) ; 
currentPath. bCreated  =  true; 

} 


//  generate  flow  response  and  send  it  to  the  sender 
response  = 

new  FlowResponse (times tamp, FlowResponse . DS_ACCEPTED, user ID, user SLS ) 
display . sendText ( "\tSending  positive  flow  response  to  DS  user"); 

} 

else 

{ 

display. sendText ( 

"\tThere  is  no  path  which  can  support  this  flow  request"); 

//  Generate  flow  response 

response  =  new  FlowResponse (timeStamp,  FlowResponse. RE JECTED) ; 

}  //  end  of  if  path  created 
}  //  end  of  if  route  is  feasable 
}//End  else  valid  customer 
//  Send  response  back  to  originator 

myServer . sendFlowResponse (response,  sourceRouterlD)  ; 

return  flowLabel; 

}//End  of  admissionControl_DS ( ) 

// [PS]  -  reviewd 
/  *  * 

*  Performs  the  admission  control  sequence  for  a  Best  Effort  flow  request. 

*  @param  flowRequest  the  flow  request. 

*  @return  and  integer  with  the  flow  label,  or  ) 
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if  not  admited. 


*/ 

protected  int  admissionControl_BE (FlowRequest  flowRequest) 

{ 

/*  [PS] 

Previous  version  of  PIB  had  BE  implemented  in  such  a  way  resources 
actually  got  allocated  after  admiting  a  new  BE  flow,  on  a  fixed  50kbps  per 
flow  basis.  This  is  contrary  to  the  logic  of  a  the  BE  service  model. 

The  whole  code  was  deleted  to  avoid  confusion  with  current  clean  resource 
allocation  algorithm. 

*/ 

display . sendText (" \n\nNew  flow  request:  Best  Effort"); 
display. sendText ( 

"Best  Effort  admission  control  is  currently  not  implemented  in  PIB.\n"  + 
"BE  flow  request  will  be  rejected!"); 

return  0; 

}  //End  of  admissionControl_BE ( ) 

//[PS]  -  created  to  support  inter-service  borrowing 
/  *  * 

*  Sets  the  state  of  the  interservice  borrowing  capability. 

*  @param  the  new  state  of  the  interservice  borrowing.  True  to  turn  it  on  and 

*  false  to  turn  it  off. 

*  @return  void 
*/ 

public  void  setInterserviceBorrowing (boolean  isBorrowingEnabled) 

{ 

this . isBorrowingEnabled  =  isBorrowingEnabled; 

display . sendText (" \nlnter-service  borrowing  status:  "  + 

((isBorrowingEnabled)  ?  "ENABLED. \n"  ;  "DISABLED . \n" )) ; 

} 


//[PS]  -  created  to  support  inter-service  borrowing 
/  *  * 

*  Sets  the  borrowing  threshold.  Inter-service  borrowing  capable  service 

*  levels,  have  a  threshold  bellow  which  borrowing  is  not  allowed.  Only 

*  capacity  above  this  limit  is  made  available  for  inter-service  borrowing; 
*/ 

public  void  setBorrowingThreshold (double  newThreshold) 

{ 

if ( (newThreshold  >=  O.Od)  &&  (newThreshold  <=  l.Od)) 

{ 

borrowingThreshold  =  newThreshold; 

} 

display . sendText (" \nBorrowing  threshold  is  "  + 

Math . round (borrowingThreshold  *  100)  + 

"  %  of  service  level  base  allocation"); 

} 


/  *  * 

*  Sets  up  a  path  by  sending  routing  tabie  update  messages  to  routers. 

*  @param  newPath  the  new  Path. 

*  Sparam  pathID  the  ID  of  the  new  path. 

*  Sreturn  void. 

*/ 

protected  void  setupPath (Path  newPath,  int  pathID) 

{ 

dispiay. sendText ( "Send  routing  tabie  updates  to  routers  in  seiected  path\n") 

Vector  vNodeSeq  =  newPath . getNodeSequence () ; 

IPv6Address  targetRouterlD  =  nuii,  nextRouterlD  =  nuii; 

Vector  vInterfaceSeq  =  newPath . getinterf aceSequence () ; 

IPv6Address  nextHopAddress  =  nuii; 

nextRouterlD  = 

(IPv6Address)  htNodelDtoRouterlD.get ( (Integer)  vNodeSeq.eiementAt (0) ) ; 

//  Both  node  and  interface  sequences  are  from  *destination  to  source* 


for  (int  ni  =  i;  ni  <  vNodeSeq. size ( ) ;  ni++) 
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//  targetRouterlD  is  where  this  routing  entry  is  going  to  be  intailed 
//  the  routing  entry  consists  of  (path-id,  next-hop-interface-address) 
targetRouterlD  = 

( IPv6Address )  htNodelDtoRouter ID . get ( (Integer)  vNodeSeq . elementAt (ni ) ) 
//  Have  to  determine  next-hop-interface-address  since  it  is  an  inbound 
//  interface  and  not  part  of  the  vInterfaceSequence  of  the  path 

//  First  find  the  outbound  interface  of  the  target  router 
//  Currently  vinterf aceSeq  contains  inbound  interfaces  as  well. 

//  Therefore,  the  code  below  won't  worlr  until  vinterf aceSeq  is  built 
//  correctly 

IPv6Address  outbound  =  (IPv6Address)  vInterfaceSeq. elementAt (ni  -  1); 

// 

//IPv6Address  outbound  =  (IPv6Address)  vInterfaceSeq. elementAt (2  *  ni  - 

// 

Interfaceinfo  outboundinfo 

=  (Interfaceinfo)  htinterfaces . get (outbound. toString ()) ; 
byte  subnetMaskLength  =  outboundinfo . getSubnetMask () ; 

//  Then  obtain  the  next  hop  router  ID,  and  then  all  interface  addresses 

//  on  that  router 

Hashtable  nextNodeInterfaces  = 

(Hashtable)  htRouterInterfaceMap . get (nextRouter ID. toString ( ) ) ; 
Enumeration  e  =  nextNodeInterfaces . elements () ; 

//  Now  search  all  these  addresses  to  find  the  inbound  interface 
//  (with  matching  network  address, 
while  (e .hasMoreElements ( ) ) 

{ 

IPv6Address  check  =  (IPv6Address)  e . nextElement ( ) ; 

if  ( Interface . isOnSameNetwork ( check,  outbound,  subnetMaskLength)) 

{ 

nextHopAddress  =  check; 
break; 

} 

} 

//[GX]  Seems  no  need  to  include  the  service  level  info 
//[GX]  1  just  for  now. 

myServer . sendFRTUpdate (targetRouterlD,  pathID,  nextHopAddress,  (byte)  1) 
nextRouterlD  =  targetRouterlD; 


//  Wait  for  the  routers  to  update  their  routing  tables 
try 
{ 

//  2-second  seems  arbitrary;  alternatively  could  rely  on  ACKs . 
Thread. sleep (2000 ) ; 

} 

catch ( InterruptedException  ie) 

{ 

display. sendText  ( 

"Exception  while  waiting  for  path  set  up.  "  +  ie . toString ()) ; 

} 


}  //  End  of  setupPathO 


y  *  * 

*  Retrieves  a  Vector  with  all  interfaces  of  PIB.  The  Enumerations  contains 

*  IPv6  addresses  as  strings  for  the  interfaces. 

*  @return  the  Enumeration  with  all  interfaces  in  PIB. 

*/ 

public  Enumeration  getPibInterf aces ( ) 

{ 

return  htinterfaces . elements () ; 

} 

/  *  * 
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*  Displays  to  screen  the  current  PIB. 

*  @return  void. 

*/ 

public  void  displayPIBO 

{ 

String  str  = 

if  (false)  //  Set  to  true  to  display  path  information  array 

{ 

str  =  "PIB  contains  following  paths:"; 
for  (int  i  =  0;  i  <  MAX_NODE_NUMBER;  i++) 

{ 

for  (int  j  =0;  j  <  MAX_NODE_NUMBER;  j++) 

{ 

for  (int  k  =  0;  k  <  MAX_HOP_COUNT;  k++) 

{ 

//  Skip  the  case  of  the  same  source  and  destination 
if  (i  ==  j)  {continue;} 

if  ( !  (aPI [i]  [ j 1  [k]  . isEmpty ( ) ) ) 

{ 

str  +=  "From  Source:  "  +  i  +  "  to  destination:  "  + 

j  +  "  on  "  +  k  +  "  hops\n"; 

//  Get  enumeration  of  pathIDs  for  each  element  of  the  3-D  array 
//  for  example  aPI[2] [3] [3]  =  {4,6,9}  -- 
//  Remember:  aPI(i](j](k]  is  a  hashtable ! ! 

Enumeration  enumPathIds  =  aPI(i] {j] { k] . elements () ; 

//  For  each  pathID,  get  the  referenced  Path  and  display  the 
//  vector  of  nodes 

while  (enumPathIds .hasMoreElements 0 )  //  Walk  through  each  path 

{ 

Integer  currentPathID  =  (Integer)  enumPathIds . nextElement () ; 
//  Append  the  next  path  ID 

str  +=  "Path:  "+  currentPathID. intValue ( )  +  "\n  "; 

Path  currentPath  =  (Path)  htPaths . get ( currentPathID) ; 
if  (currentPath  ==  null)  {break; } 

if  (false)  //  Set  to  true  to  display  Path  QoS  information 

{ 

//  Extract  that  path's  information 

PathQoS  x(]  =  currentPath . getPathQoSArray 0 ; 

for  (int  w  =  0;  w  <  currentPath . obj PathQoS . length;  w++) 

{ 

PathQoS  test  =  x(w]; 

str  +=  "Available  Bandwidth;  "  + 

test . getAvailableBandwidth ( )  +  "\n"; 
str  +=  "Delay:  "  +  test . getPacketDelay ( )  +  "\n"; 
str  +=  "LossRate:  "  +  test . getPacketLossRate ( )  +  "\n\n"; 

} 


}  //  End  if  for  QoS  display 

//  Set  to  true  to  display  the  sequence  of  the  nodes  the 
//  path  traverses 
if  (true) 

{ 

str  +=  currentPath . toString 0 ; 

}//  End  if  for  Node  Sequence  display 


//  Set  to  true  to  display  the  Interface  Sequence  traversed  by 
//  a  path; 
if  (false) 

{ 

str  +=  currentPath . toString 0 ; 

}//  End  Interface  Sequence  Display  block 
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}  //  End  currentPath  while  loop 

}//  End  if  statement  for  processing  non-empty  pathID  hashtables 
}  //  End  hop-count  based  loop 
}  //  End  destination  based  loop 
}  //  End  source  based  loop 
}//  End  if  for  path  information  array  display 


if  (true)  //  Set  to  true  to  display  all  current  paths  in  the  PIB; 

{ 

str  +=  toStringPaths ( 1 ) ; 

} 

//  Set  to  true  to  display  all  current  interfaces  in  PIB  and  their 
//  QoS  settings: 
if  (true) 

{ 

str  +=  toStringInterfaces  ( )  ; 

} 

//  Dump  string  to  display 
display. sendText (str) ; 

}  //  End  of  displayPIBO 

/  *  * 

*  Used  during  test  mode  to  display  additional  information  to  the  demo  station 

*  gui . 

*  @param  msg  the  additional  information  to  be  displayed. 

*  @return  void. 

*/ 

protected  void  testMsg (String  msg)  { 
if  (DISPLAY_FULL_DETAIL) 

{ 

display . sendText ( "\t\t\t\t\t [TM]  "  +  msg) ; 

} 

}  //  End  testMsg 0 

}  //  End  of  Pathinf ormationBase  class 
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APPENDIX  C  PIB  TESTER  SOURCE  CODE 


//July  2001  [Paulo  Silva]  -  created 
package  saam. server; 


import 

import 

import 

import 

import 

import 


java . io . * ; 
java .util . * ; 
j  ava . awt . * ; 
java. text. *; 
j  ava . awt . event . * ; 
j  avax . swing . * ; 


import  saam. agent . server . ServerAgent; 
import  saam. message ; 
import  saam.net. IPv6Address; 
import  saam. util . j gl ; 


/  *  * 

*  PibTester  is  a  test  drive  for  the  PIB  (BasePIB) .  This  class  is  instantiated 

*  from  within  BasePIB  whenever  the  test  flag  of  BasePIB  is  set  to  true.  The 

*  tester,  has  its  own  GUI  interface  and  may  be  used  for  testing  or  monitoring 

*  PIB  behavior.  Testing  means  the  ability  to  model  generation  of  IS  and  DS  flow 

*  request  messages,  associated  LSA  messages  and  send  them  to  PIB.  Monitoring 

*  means  ability  to  query  PIB  about  its  state,  like  Path  status  or  Interface 

*  status.  Simulation  results  are  dumped  to  a  file  in  column  format  for 

*  firther  analysis.  Make  a  search  for  //columns  to  discover  the  column  key. 

*  @author  Paulo  Silva  (August  2001) 

*/ 

public  class  PibTester  extends  JFrame  implements  ActionListener ,  Runnable 

{ 


//Available 

types 

of  simulation  events 

public  final 

byte 

TYPE  FLOW  REQUEST  =  1; 

public  final 

byte 

TYPE  FLOW  TERMINATION  =  2; 

public  final 

byte 

TYPE  LSA  =  3; 

//Support  data  members 
public  final  int 

IS 

=  0, 

//IntServ 

DS 

=  1, 

/ /DiffServ 

REQ 

=  0, 

//Flow  requests 

REJ 

=  1, 

//Flow  rejections 

ACT 

=  2, 

//Active  flows 

RJR 

=  0, 

//Rejection  rate 

RRA 

=  1, 

//Rejection  rate  average 

EMA 

=  2; 

//Weighted  exponential  moving  average 

private  boolean  isReady  =  false; 
private  PrintWriter  dataOut  =  null; 
private  String  dataLine  =  null; 
private  byte  allowBorrowing  =  1; 
private  int  refreshMode  =  0; 
protected  Thread  timer; 
private  int  numServiceLevels ; 
private  Object  theLock  =  new  Object (); 
private  BasePIB  pib; 
private  Hashtable  htinterfaces; 
private  JglPriorityQueue  queue; 

//Simulation  variables 
double  borrowingThreshold  =  0.5d; 
double  alphaFactor  =  0.5d; 
long  seed; 

Random  randomGen; 

boolean  runSimulation  =  false; 
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boolean  isReleased  =  false; 
boolean  abortRun  =  false; 
private  double  timeFactor  =  l.Od; 


int  IsaCycle; 

int  flowReqIntervallS;  //sec 

int  durationMeanIS;  //sec 

int  durationSigmalS;  //sec 

int  flowBwIS;  //bps 

int  f lowReqIntervalDS ;  //sec 

int  durationMeanDS;  //sec 

int  durationSigmaDS;  //sec 

int  flowBwDS;  //bps 

int  eventCounter  =  0; 
int  projActiveFlowsIS  =  0; 

int  pro j ActiveFlowsDS  =  0; 

final  int  INT  =  3; 
final  int  DBL  =  3; 


final  int  SIM_DATA  =  INT  +  DBL; 
int  data [ ] [ ]  =  new  int[2][INT]; 
double  rrData[] []  =  new  double[2] [DBL] ; 
int  simState  =  -1; 

//For  the  moving  average 
private  boolean  [] []  req; 
private  int  []  reqCount  =  new  int[2]; 
private  int  movAvgWindowSize  =  0; 

//Gui  data 

private  String  []  modeLabel  =  {"Display  mode:  ref resh" , "Display  mode:  normal"}; 

private  String  []  borrowingLabel  =  {"Turn  borrowing  ON", "Turn  borrowing  OFF"}; 

private  String  []  control  =  { "S  T  A  R  T" , "S  T  0  P  " ,  "CONTINUE"}; 

private  DecimalFormat  df  =  (DecimalFormat) NumberFormat . getCurrencyInstance ( ) ; 

private  int  nrButtons; 

private  String  text  =  new  String (); 

private  JLabel  IblTimer; 

private  JButton  []  button; 

private  JButton  bEvent; 

private  JButton  bGet; 

private  JPanel  buttonPanel; 

private  JPanel  topPanel; 

private  JTextArea  tArea; 

private  JTextField  tField; 

private  JTextField  {}  txtField; 

private  JLabel  dataLabel  {} {}=  new  JLabel{2] [SIM_DATA] ; 
final  int  BUTTON  PANEL  ROWS  =  18; 


private  String []  bLabel  =  { 

"L  0  A  D",  //O 

control {0} ,  //I 

"A  B  0  R  T",  //2 

modeLabel {refreshMode} ,  //3 

"Queue",  //4 

"Interfaces  -  Sim",  //5 

"Interfaces  -  PIB",  //6 

"Paths  -  PIB",  111 

borrowingLabel [allowBorrowing] ,  //8 
"Reset  PIB  QoS",  //9 

"Clear  Screen",  //lO 

"Exit"};  //ll 


final  int 

SIM_L0AD  =  0, 
SIM_C0NTR0L  =  1, 
SIM_AB0RT  =  2, 
SIM_REFRESH_MODE  =  3, 
SIM_QUEUE  =  4, 
SIM_INTERFACES  =  5, 
PIB_INTERFACES  =  6, 
PIB_PATHS  =  7, 
PIB_B0RR0WING  =  8, 
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PIB_RESET  =  9, 

SIM_CLS  =  10, 

SIM_EXIT  =  11, 

INPUT  =  -1; 

final  int 

SIM_DURATION  =  0, 

SIM_TIME_FACTOR  =  1, 

SIM_LSA_CYCLE  =  2, 

SIM_MOV_AVG_WINDOW  =  3, 

SIM_ALPHA  =  4, 

SIM_SEED  =  5, 

SIM_THRESHOLD  =  6, 

SIM_FILE_NAME  =  7, 

IS_ARRIVALS  =  8, 

IS_MU  =  9, 

IS_SIGMA  =  10, 

IS_BW  =  11, 

DS_ARRIVALS  =  12, 

DS_MU  =  13, 

DS_SIGMA  =  14, 

DS_BW  =  15, 

STATE_UNLOADED  =  -1, 

STATE_READY_TO_START  =  0, 

STATE_RUNNING  =  1, 

STATE_STOPPED  =  2; 

/  *  * 

*  Constructor. 

*  @param  pib  a  reference  to  the  BasePIB  class. 

*/ 

public  PibTester (BasePIB  pib) 

{ 

super ("Pib  Tester  v  3.3  (August  2001)"); 
this. pib  =  pib; 
this.setSize (1000,500)  ; 
initializeGUI () ; 

queue  =  new  JglPriorityQueue (new  GreaterThan ( ) ) ; 
htinterfaces  =  new  HashtableO; 

df  =  ( DecimalFormat ) NumberFormat . getCurrencyInstance ( )  ; 
df . setMaximumFractionDigits ( 2 )  ; 
df . applyPattern ( "#0 . 00%" )  ; 

numServiceLevels  =  pib . NUM_OF_SERVICE_LEVELS ; 

}//end  of  constructor 
/  *  * 

*  Processes  simulation  events  of  type  flow  request. 

*  @param  the  simluation  event. 

*/ 

private  void  processEvent_FlowRequest ( SimulationEvent  event) 

{ 

boolean  isAccepted  =  false; 

String  displayStr  =  event . toString ( )  +  "\t  ->  "; 

FlowRequest  flowRq  =  ( FlowRequest) event . getEventObj ect () ; 
byte  slindex  =  (byte) (f lowRq. getServiceLevel ( )  -  1); 
int  bandwidth  =  f lowRq . getRequestedBandwidth ( ) ; 

int  duration  =  (int) (event . getStopTime ( )  -  event . getStartTime ()) ; 

//For  the  data  log 

dataLine  +=  +  (slIndex+1) +", "  +  bandwidth  +  +  duration; //columns  4-6 

//Update  counter 

data [slindex] [REQ1++;  //Increment  number  of  flow  request  for  this  svcLevel 
Vector  vinterfaces; 

//Process  flow  request  in  PIB  and  retrieve  all  interfaces  traversed  if  any. 
synchronized (theLock) 

{ 

vinterfaces  =  pib.processFlowRequest_test (flowRq) ; 
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} 


//Check  if  flow  was  accepted 
if (vinterfaces  .  size  ( )  >  0) 

{ 

displayStr  +=  "ACCEPTED"; 

isAccepted  =  true; 

dataLine  +=  ",1";  //column  7 

data [slindex] [ACT]++;  //Increment  number  of  active  flows 

//  Step  through  all  interfaces  traversed  by  the  flow 
//  Keep  track  of  allocated  BW  per  interface/servicel  level 

//  Construct  a  vector  of  interfaces 
Vector  vIFaces  =  new  Vector (1); 

Enumeration  einterfaces  =  vinterfaces . elements () ; 
while (einterfaces .hasMoreElements () ) 

{ 

//Get  next  element  (affected  interface) 

String  address  =  (( IPv6Address ) einterfaces . nextElement ()). toString () ; 
//Get  next  element  (routerlD) 

String  routerlD  =  (( IPv6Address ) einterfaces . nextElement ()). toString () ; 
//Get  next  element  (interface  bandwidth) 

int  InterfaceBW  =  (( Integer ) einterfaces . nextElement ()). intValue () ; 
vIFaces . add ( 

new  FlowTerminationData (address, (byte) (slindex  +  1),  bandwidth)); 

//  Add  the  interfaces  to  the  set  of  affected  interfaces 
if ( ! ht Inter faces . containsKey (address . toString ( )  )  ) 

{ 

htinterfaces .put (address,  new  Interface (routerlD,  InterfaceBW)); 

} 

Interface  iFace  =  (Interface)htlnterfaces.get(address); 
iFace . increaseAllocatedBW ( (byte ) (slindex  +  I),  bandwidth); 

}//end  of  while 

//Create  a  flow  termination  event  and  insert  it  in  the  priority  queue 
SimulationEvent  simEvent  = 

new  SimulationEvent (TYPE_FLOW_TERMINATION,  event . getStopTime () ,  vIFaces) 
queue. add (simEvent) ; 


} 

else 

{ 

displayStr  +=  "REJECTED"; 
dataLine  +=  ",0";  //column  7 
data [slindex] [REJ1++; 

if (tField. getText ( ) . equals ( "beep" ) ) 

{ 

this . getToolkit ( ) .beep ( ) ; 

} 


//Compute  new  rejection  rate  moving  average 

//Limit  the  maximum 
reqCount [slindex]  += 

(reqCount [slindex]  ==  movAvgWindowSize)  ?  0  :  1; 

boolean  last  =  req [slindex] [reqCount [slindex]  -  1]; 

//Shift  all  elements  one  position 

for (  int  i  =  reqCount [slindex]  -  1;  1  >=  1;  1--) 

{ 

req [slindex]  [i]  =  req [ slindex]  [ i-1 ] ; 

} 

req[sllndex] [0]  =  isAccepted;  //insert  new  at  front 
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//Average 

int  sumRejected  =  0; 

for(int  i  =  0;  i  <  reqCount [slindex] ;  i++) 

{ 

sumRejected  +=  (! req [slindex] [i] )  ?  1  :  0; 

} 

//Store  the  new  refection  rate  average 

rrData [slindex] [RRA]  =  (double) sumRejected  /  (double) reqCount [slindex] 

//Wheighted  exponential  moving  average 
rrData [slindex] [EMA]  = 

alphaFactor  *  rrData [slindex] [RRA] 

+  (1  -  alphaFactor)  *  rrData [slindex] [EMA] ; 

if ( ref reshMode  ==  1) 

{ 

synchronized (theLock) 

( 

displayStr  +=  "\n"  +  pib . toStringInterf aces ( 2 ) ; 

} 

display (displayStr ,  true);  //Reset  display  first 

} 

else 

{ 

display (displayStr) ; 

} 

}//end  of  processEvent_FLowRequest 
/  *  * 

*  Process  a  generic  simulation  event. 

*  @param  event  the  simulation  event. 

*  @return  void. 

*/ 

private  void  processEvent ( SimulationEvent  event) 

( 

/ /dataOuteventCounter 

byte  type  =  event . getType () ; 

eventCounter++; 

//For  the  data  file:  columns  1-3 

dataLine  =  event . getStartTime ( )  +  +  eventCounter  +  +  type; 

switch  (event . getType 0 ) 

( 

case  TYPE_FLOW_REQUEST; 

processEvent_FlowRequest (event) ; 
break; 

case  TYPE_FLOW_TERMINATION: 

processEvent_FlowTermination (event) ; 
break; 

case  TYPE_LSA; 

processEvent_LSA (event) ; 

//For  the  data  file:  columns  4-7 

dataLine  += 

break; 

}  //end  switch 

//refresh  gui 
ref reshSimOutput ( ) ; 

//Include  for  data  log,  all  current  statistical  information 
//columns  8-19 
dataLine  +=  + 

data [IS] [REQ]  +  "  + 

data [IS] [REJ]  +  "  + 

data  [IS]  [ACT]  +  ", "  + 
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rrData [IS] [RJR]  +  "  + 

rrData [IS] [RRA]  +  + 

rrData [IS] [EMA]  +  + 

data [DS] [REQ]  +  "  + 

data [DS] [REJ]  +  ", "  + 
data [DS] [ACT]  +  ", "  + 
rrData [DS] [RJR]  +  + 

rrData [DS] [RRA]  +  ","  + 

rrData [DS] [EMA] ; 
dataOut.println (dataLine) ; 

} 


/  *  * 

*  Process  a  simulation  event  of  type  flow  termination. 

*  @param  event  the  simulation  event.  In  this  case  is  a  vector  containing  flow 

*  termination  objects.  Each  of  these  object  contain  data  about  a  single 

*  interface. 

*  @return  void. 

*/ 

private  void  processEvent_FlowTermination ( SimulationEvent  event) 

( 

String  displayStr  =  event . toString  () ; 

byte  serviceLevel  =  0; 
int  bandwidth  =  0; 

//Step  through  all  interfaces  affected  by  the  terminated  flow 
Enumeration  elFaces  =  ( (Vector ) event . getEventObject ()). elements () ; 
while (elFaces .hasMoreElements ( ) ) 

( 

//Get  the  flow  termination  data  for  one  interface  at  a  time 
FlowTerminationData  ftData  =  (FlowTerminationData) elFaces . nextElement () ; 
String  address  =  ftData . getAddress () ; 
serviceLevel  =  ftData . getServiceLevel () ; 
bandwidth  =  ftData . getBandwidth () ; 

//Update  the  allocated  bandwidth  of  this  interface 
Interface  theinterface  =  (Interface)htlnterfaces.get(address); 
theinterf ace . decreaseAllocatedBW ( serviceLevel ,  bandwidth) ; 

}//end  while 

//Update  counter 

data [serviceLevel-1] [ACT]--; 

//Prepare  a  data  line  for  data  output 
dataLine  +=  +  serviceLevel;  //column  4 

dataLine  +=  +  bandwidth;  //column  5 

dataLine  +=  //column  6-7 

//Refresh  gui  display 
if ( ref reshMode  ==  1) 

{ 

synchronized (theLock) 

( 

displayStr  +=  "\n"  +  pib . toStringInterf aces ( 2 ) ; 

} 

display (displayStr ,  true);  //Reset  display  first 

} 

else 

( 

display (displayStr) ; 

} 


/  *  * 

*  Processes  a  simulation  event  of  type  LSA. 

*  @param  event  the  simulation  event. 

*  @return  void. 

*/ 

private  void  processEvent_LSA (SimulationEvent  event) 
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{ 

string  displayStr  =  event . toString ( )  +  "  #  " 

+  ( (Integer) event . getEventObject ( ) )  . toString ( )  ; 

//Data  initialization 

Hashtable  htLSAbyRouterlD  =  new  HashtableO; 

//Step  through  all  interfaces  that  habe  been  affected  by  flows 

//and  create  and  store  the  interface  ISA  which  in  turn  will  contain  two  SSAs 

//pertaining  to  utilization  of  IS  and  DS,  and  the  routerlD 

Enumeration  allinterfaces  =  htinterf aces . keys () ; 

while (allinterfaces .hasMoreElements () ) 

{ 

//Retrieve  address  and  the  interface  object 

String  address  =  ( String) allinterf aces . nextElement () ; 

Interface  thisinterface  =  ( Interface) htinterfaces . get (address) ; 

String  hostRouterlD  =  thisinterface . getRouterlD () ; 

//Create  interface  status  advertisement  (ISA) 

InterfaceSA  isa  =  null; 
try 
( 

//Using  this  constructor,  it  is  an  ISA  of  type  update 
isa  =  new  InterfaceSA ( IPv6Address . getByName (address) ) ; 

} 

catch (Exception  e) 

{ 

e  .print StackTr ace ( ) ; 

} 


//Update  IS  utilization 

double  slAllocatedBW  =  thisinterface . getAllocatedBW (BasePIB . INT_SERV) ; 
double  IFaceBW  =  thisinterface . getBandwidth () ; 

short  utilization  =  (short) (slAllocatedBW/iFaceBW/ServiceSA.UTIL_UNIT) ; 
isa . insert ServiceLevelSA ( 

new  ServiceSA (BasePIB . INT_SERV, ServiceSA.UTILIZATION_TYPE, utilization) ) ; 
//Update  DS  utilization 

SlAllocatedBW  =  thisinterface . getAllocatedBW (BasePIB . DIFF_SERV) ; 
utilization  =  (short) (slAllocatedBW/iFaceBW/ServiceSA.UTIL_UNIT) ; 

isa . insert ServiceLevelSA ( 

new  ServiceSA (BasePIB . DIFF_SERV, ServiceSA. UTILIZATION_TYPE, utilization) ) 

//Create  a  new  LSA  if  no  Isa  exists  for  this  routerlD.  Add  this  ISA  to  it 
if  (htLSAbyRouterlD. containsKey (hostRouterlD) ) 

{ 

//LSA  already  created  for  this  router.  Retrieve  it  and  add  ISA 
LinkStateAdvertisement  Isa  = 

(LinkStateAdvertisement ) htLSAbyRouterlD . get (hostRouterlD)  ; 

Isa . insertInterfaceSA (isa)  ; 

} 

else 

{ 

//First  LSA  for  this  router.  Create  LSA  and  add  ISA 
LinkStateAdvertisement  Isa  =  null; 
try 
{ 

Isa  =  new  LinkStateAdvertisement ( IPv6Address . getByName (hostRouterlD) ) ; 

} 

catch (Exception  e) 

{ 

e .printStackTrace ( ) ; 

} 

Isa . insertInterfaceSA (isa) ; 
htLSAbyRouterlD. put (hostRouterlD,  Isa) ; 

} 

}//end  while  loop  to  step  through  all  interfaces 
//Step  through  all  LSA's  and  send  them  to  PIB 
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int  count  =  htLSAbyRouterlD. size ( ) ; 
int  counter  =  1; 

Enumeration  eRouters  =  htLSAbyRouterlD . elements () ; 
synchronized (theLock) 

{ 

while  (eRouters . hasMoreElements ( ) ) 

{ 

LinkStateAdvertisement  Isa  = 

(LinkStateAdvertisement) eRouters . nextElement ( ) ; 
pib .processLSA (Isa) ; 

} 

displayStr  +=  "\t  LSA's;  "  +  count; 

if ( ref reshMode  ==  1) 

{ 

displayStr  +=  "\n"  +  pib . toStringInterf aces  ( 2 ) ; 
display (displayStr ,  true);  //Reset  display  first 

} 

else 

{ 

display (displayStr) ; 

} 


/  *  * 

*  Displays  the  interfaces  currently  stored  in  the  tester,  i.e.  those  that 

*  have  changed  due  to  resource  allocation. 

*  @return  void. 

*/ 

private  void  displayinterf aces ( ) 

{ 

int  count  =  0; 

display ("Interfaces  in  the  PibTester  (traversed  by  flows)"); 

Enumeration  keys  =  htinterf aces . keys () ; 


while ( keys . hasMoreElements ( ) ) 

{ 

String  address  =  ( String) keys . nextElement () ; 
display ( ("Interface  "  +  (t+count)  +  ";  "  +  address)); 
Interface  iFace  =  ( Interface) htinterfaces . get (address) ; 
for (byte  si  =  0;  si  <  numServiceLevels  -  1;  sl+t) 

{ 

display ((si  +  "  -  "  +  iFace. getAllocatedBW (si) )) ; 

} 

} 

} 


y  *  * 

*  Displays  the  contents  of  the  simulation  priority  queue. 

*  @return  void. 

*/ 

private  void  displayQueue ( ) 

{ 

String  out  = 
int  count  =  0; 

Enumeration  e  =  queue . elements () ; 
while (e .hasMoreElements ( ) ) 

{ 

SimulationEvent  event  =  ( SimulationEvent ) e . nextElement () ; 
out  +=  (t+count)  +  ":\t"  +  event . toString ( )  +  "\n"; 

} 

display ( "Simulation  Queue  -  "  +  count  +  "  events"); 
display (out) ; 


y  *  * 

*  GUI  initialization 

*  @return  void. 

*/ 
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private  void  initializeGUI ( ) 

{ 

nrButtons  =  bLabel . length; 
button  =  new  JButton [nrButtons] ; 

Container  c  =  getContentPane ( ) ; 
c . setLayout (new  Border Layout (5,5) ) ; 

//center  panel 

tArea  =  new  JTextArea (text, 25, 30) ; 
tArea . setAutoscrolls (true) ; 
tArea . setEdi table (false) ; 

tArea . setBackground (new  Color(242,182,132) ) ; 

tArea . setFont (new  Font ( "Courier  New",  Font. BOLD,  12)); 

c . add (new  JScrollPane (tArea) , BorderLayout . CENTER) ; 

//bottom 

tField  =  new  JTextField (30) ; 

tField . addActionListener (this) ; 

tField . setBackground (new  Color(198,237,176) ) ; 

tField. setFont (new  Font ( "Courier  New",  Font. BOLD,  12)); 

c . add (tField,  BorderLayout . SOUTH) ; 

//right  panel  -  button  panel 

buttonPanel  =  new  JPanel (new  GridLayout (BUTTON_PANEL_ROWS, 1) ) ; 
buttonPanel . add (new  JPanel ()); 

IblTimer  =  new  JLabel ( f ormatTime ( 0 ) ,  JLabel . CENTER) ; 

for(int  i  =  1;  i  <  BUTTON_PANEL_ROWS  -  nrButtons  -  1;  i++) 

{ 

buttonPanel . add (new  JPanel  ()); 

} 


buttonPanel . add ( IblTimer) ; 

for(int  i  =  0;  i  <=  nrButtons  -  1;  i++) 

{ 

button [i]  =  new  JButton (bLabel [ i ]) ; 
button [i] .addActionListener (this) ; 
buttonPanel . add (button [i] ) ; 


button [SIM_CONTROL] . setEnabled (false) ; 
button [SIM_ABORT] . setEnabled  (false) ; 
button [SIM_L0AD] . setEnabled (false) ; 

c.add (buttonPanel, BorderLayout. EAST) ; 

//left  panel 
JPanel  p; 

JPanel  leftPanel  =  new  JPanel (new  GridLayout (0, 1)  )  ; 
txtField  =  new  JTextField [ 1 8 ] ; 
int  i  =  0; 

/  /  Row 

leftPanel. add (new  JLabel ( "SIMULATION  DATA  INPUT" , JLabel . CENTER) ) 
/  /  Row 

p  =  new  JPanel (new  GridLayout ( 1 , 2 )) ; 
p.add(new  JLabel ( "Duration  (s)  ",  JLabel .RIGHT) ) ; 
txtField [SIM_DURATION]  =  new  JTextField("3600",5); 
p.add(txtField[SIM_DURATION] ) ; 
leftPanel . add (p) ; 

/  /  Row 

p  =  new  JPanel (new  GridLayout ( 1 , 2 )) ; 
p.add(new  JLabel ("Time  factor  ",  JLabel .RIGHT) ) ; 
txtField [SIM_TIME_FACTOR]  =  new  JTextField("0.2",5); 
p.add(txtField[SIM_TIME_FACTOR] ) ; 
leftPanel . add (p) ; 
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/  /Row 

p  =  new  JPanel (new  GridLayout ( 1 , 2 ) ) ; 
p,add(new  JLabel("LSA  Cycle  (ms)  ",  JLabel .RIGHT) ) ; 
txtField [SIM_LSA_CYCLE]  =  new  JTextField("300",5); 
p,add(txtField[SIM_LSA_CYCLE] ) ; 
leftPanel , add (p) ; 

/  /Row 

p  =  new  JPanel (new  GridLayout ( 1 , 2 ) ) ; 

p.add(new  JLabel ( "Moving  Avg  (#  flow  reqs)",  JLabel .RIGHT) ) ; 
txtField [SIM_MOV_AVG_WINDOW]  =  new  JTextField ( "20 " , 5 ) ;  //default  10 
p.add(txtField[SIM_MOV_AVG_WINDOW] ) ; 
leftPanel . add (p) ; 

/  /Row 

p  =  new  JPanel (new  GridLayout ( 1 , 2 )) ; 

p.add(new  JLabel ("EWMA  -  weigth  factor",  JLabel .RIGHT) ) ; 
txtField [SIM_ALPHA]  =  new  JTextField ( "0 . 5" , 5 ) ; 
p. add (txtField [SIM_ALPHA] ) ; 
leftPanel . add (p) ; 

/  /Row 

p  =  new  JPanel (new  GridLayout ( 1 , 2 )) ; 

p.add(new  JLabel ( "Random  no.  generator  seed",  JLabel .RIGHT) ) ; 
txtField [SIM_SEED]  =  new  JTextField ("100", 5) ; 
p. add (txtField [SIM_SEED] ) ; 
leftPanel . add (p) ; 

/  /Row 

p  =  new  JPanel (new  GridLayout ( 1 , 2 )) ; 

p.add(new  JLabel ( "Borrowing  threshold  (%)",  JLabel .RIGHT) ) ; 
txtField [SIM_THRESHOLD]  =  new  JTextField("50",5); 
p. add (txtField [SIM_THRESHOLD] ) ; 
leftPanel . add (p) ; 

/  /Row 

p  =  new  JPanel (new  GridLayout ( 1 , 2 )) ; 

p.add(new  JLabel ( "Output  file  name  ",  JLabel .RIGHT) ) ; 
txtField [SIM_FILE_NAME]  =  new  JTextField (" SimData_l . txt" , 5 ) ; 
p. add (txtField [SIM_FILE_NAME] ) ; 
leftPanel . add (p) ; 

/  /Row 

leftPanel. add(new  JLabel (" INTEGRATED  SERVICE  FLOWS" , JLabel . CENTER) ) ; 
/  /Row 

p  =  new  JPanel (new  GridLayout ( 1 , 2 )) ; 

p.add(new  JLabel ("Interarrival  time  (s)  ",  JLabel .RIGHT) ) ; 
txtField[IS_ARRIVALS]  =  new  JTextField("l",5); 
p. add (txtField [ I S_ARRIVALS] ) ; 
leftPanel . add (p) ; 

/  /Row 

p  =  new  JPanel (new  GridLayout ( 1 , 2 )) ; 

p.add(new  JLabel ("Mean  duration  (s)  ",  JLabel .RIGHT) ) ; 
txtField [ IS_MU]  =  new  JTextField ("100", 5) ; 
p . add (txtField [ IS_MU] ) ; 
leftPanel . add (p) ; 

/  /Row 

p  =  new  JPanel (new  GridLayout ( 1 , 2 )) ; 

p.add(new  JLabel ( "Variance  (s)  ",  JLabel .RIGHT) ) ; 

txtField [ IS_SIGMA]  =  new  JTextField ("10", 5) ; 

p . add (txtField [ IS_SIGMA] ) ; 

leftPanel . add (p) ; 

/  /Row 

p  =  new  JPanel (new  GridLayout ( 1 , 2 )) ; 

p.add(new  JLabel ( "Bandwidth  (kbps)  ",  JLabel .RIGHT) ) ; 
txtField [ IS_BW]  =  new  JTextField ("6", 5) ; 
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p .  add (txtField [ IS_BW] ) ; 
leftPanel . add (p) ; 


/  /  Row 

leftPanel. add (new  JLabel ( "DIFFERENTIATED  SERVICE  FLOWS" , JLabel . CENTER) ) 


/  /  Row 

p  =  new  JPanel (new  GridLayout  ( 1 , 2 ) ) ; 

p.add(new  JLabel ("Interarrival  time  (s)  ",  JLabel.RIGHT)); 
txtField [DS_ARRIVALS]  =  new  JTextField("10",5); 
p. add ( txtField [DS_ARRIVALS] ) ; 
leftPanel . add (p) ; 

/  /  Row 

p  =  new  JPanel (new  GridLayout ( 1 , 2 )) ; 

p.add(new  JLabel ("Mean  duration  (s)  ",  JLabel.RIGHT)); 

txtField [ DS_MU]  =  new  JTextField ( "200 " , 5 ) ; 
p . add (txtField [DS_MU] ) ; 
leftPanel . add (p) ; 

/  /  Row 

p  =  new  JPanel (new  GridLayout ( 1 , 2 )) ; 
p.add(new  JLabel ( "Variance  (s)  ",  JLabel.RIGHT)); 
txtField [DS_SIGMA]  =  new  JTextField ( "20 " ,  5); 
p . add (txtField [DS_SIGMA] ) ; 
leftPanel . add (p) ; 

/  /  Row 

p  =  new  JPanel (new  GridLayout ( 1 , 2 )) ; 

p.add(new  JLabel ( "Bandwidth  (kbps)  ",  JLabel.RIGHT)); 
txtField [ DS_BW]  =  new  JTextField ( "7 ",  5 ) ; 
p . add (txtField [DS_BW] ) ; 
leftPanel . add (p) ; 


/  /  Row 

leftPanel. add (new  JLabel ( "SIMULATION  DATA  OUTPUT" , JLabel .CENTER)); 


/  /  Row 

p  =  new  JPanel (new  GridLayout ( 1 , 3 )) ; 
p. add (new  JLabel  ()); 

p . add (new  JLabel ( " IntServ" , JLabel . CENTER) ) ; 
p . add (new  JLabel ( "Dif f Serv" , JLabel . CENTER) ) ; 
leftPanel . add (p) ; 


/  /  Row 

p  =  new  JPanel (new  GridLayout ( 1 , 3 )) ; 

p.add(new  JLabel ("Flow  requests" , JLabel .RIGHT) ) ; 

dataLabel [IS] [REQ]  =  new  JLabel ("", JLabel . CENTER) ; 

dataLabel [DS] [REQ]  =  new  JLabel ("", JLabel . CENTER) ; 

p.add (dataLabel [IS] [REQ] ) ; 

p.add (dataLabel [DS] [REQ] ) ; 

leftPanel . add (p)  ; 


/  /  Row 

p  =  new  JPanel (new  GridLayout ( 1 , 3 )) ; 

p . add (new  JLabel ( "Rejected" , JLabel .RIGHT) ) ; 

dataLabel [IS] [REJ]  =  new  JLabel ("", JLabel . CENTER) ; 

dataLabel [DS] [REJ]  =  new  JLabel ("", JLabel . CENTER) ; 

p.add (dataLabel [IS] [REJ] ) ; 

p.add (dataLabel [DS] [REJ] ) ; 

leftPanel . add (p)  ; 


/  /  Row 

p  =  new  JPanel (new  GridLayout ( 1 , 3 )) ; 

p.add(new  JLabel ( "Active  f lows" , JLabel .RIGHT) ) ; 

dataLabel [IS] [ACT]  =  new  JLabel ("", JLabel . CENTER) ; 

dataLabel [DS] [ACT]  =  new  JLabel ("", JLabel . CENTER) ; 

p.add (dataLabel [IS] [ACT] ) ; 

p.add (dataLabel [DS] [ACT] ) ; 

leftPanel . add (p) ; 
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/  /  Row 

p  =  new  JPanel (new  GridLayout  ( 1 , 3 ) ) ; 

p.add(new  JLabel ("Rejection  rate" , JLabel .RIGHT) ) ; 

dataLabel [IS] [INT  +  RJR]  =  new  JLabel ("", JLabel . CENTER) 

dataLabel [DS] [INT  +  RJR]  =  new  JLabel ("", JLabel . CENTER) 

p. add (dataLabel [IS] [INT  +  RJR]); 

p. add (dataLabel [DS] [INT  +  RJR]); 

leftPanel . add (p) ; 


/  /  Row 

p  =  new  JPanel (new  GridLayout ( 1 , 3 )) ; 

p.add(new  JLabel ("Rejection  rate  avg" , JLabel .RIGHT) ) ; 
dataLabel [IS] [INT  +  RRA]  =  new  JLabel ("", JLabel . CENTER) 
dataLabel [DS] [INT  +  RRA]  =  new  JLabel ("", JLabel . CENTER) 
p. add (dataLabel [IS] [INT  +  RRA]); 
p. add (dataLabel [DS] [INT  +  RRA] ) ; 
leftPanel . add (p) ; 


/  /  Row 

p  =  new  JPanel (new  GridLayout ( 1 , 3 )) ; 
p.add(new  JLabel ( "EMMA" , JLabel .RIGHT) ) ; 

dataLabel [IS] [INT  +  EMA]  =  new  JLabel ("", JLabel . CENTER) 
dataLabel [DS] [INT  +  EMA]  =  new  JLabel ("", JLabel . CENTER) 
p. add (dataLabel [IS] [INT  +  EMA]); 

р.  add (dataLabel [DS] [INT  +  EMA]); 
leftPanel . add (p) ; 

с .  add ( leftPanel , Border Layout .WEST) ; 

pack  ( )  ; 
show  ( )  ; 


y  *  * 

*  Displays  a  string  to  the  GUI  interface. 

*  @param  str  the  String  to  be  displayed. 

*  @return  void. 

*/ 

private  void  display ( String  str) 

( 

tArea. append (str  +  "\n"); 

} 

/  *  * 

*  Displays  a  string  to  the  GUI  interface. 

*  @param  str  the  String  to  be  displayed. 

*  @param  isClearScreen  optional  clear  screen 

*  Sreturn  void. 

*/ 

private  void  display ( String  str,  boolean  IsClearScreen) 

{ 

if (IsClearScreen) 

{ 

tArea . setText ( "\n"  +  str  +  "\n"); 

} 

else 

( 

tArea. append (str  +  "\n"); 

} 


/  *  * 

*  Formats  time  for  display. 

*  @param  the  time  for  display  in  miliseconds. 

*  @return  a  String  representation  of  the  provided  time. 
*/ 

private  String  f ormatTime ( long  time) 

{ 

time  =  Math . round (time/ 1000 ) ; 


long  hours  =  time/3600; 
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time  -=  hours  *  3600; 
long  minutes  =  time/60; 
time  -=  minutes  *  60; 

String  min  =  String . valueOf (minutes ) ; 
if  (min . length ( )  ==  1) 

{ 

min  =  "0"  +  min; 

} 

String  secs  =  String. valueOf (time) ; 
if  (secs . length ( )  ==  1) 

{ 

secs  =  "0"  +  secs; 

} 

return  (  String . valueOf (hours )  +  +  min  +  +  secs  ) 

} 

/  *  * 

*  GUI  event  control. 

*  @param  e  the  GUI  action  event 

*  @return  void. 

*/ 

public  void  actionPerf ormed (ActionEvent  e) 

{ 

int  index  =  -1; 
int  option  =  0; 

String  input; 

Object  src  =  e . getSource  ( ) ; 

//Get  the  index  number  of  the  button  pressed  (if  any) 
if (src . getClass ( )  ==  button [0 ]. getClass  () ) 

{ 

for (int  i  =  0;  i  <  nrButtons;  i++) 

{ 

if (src. equals (  (Object) button [i]  )) 

{ 

index  =  i; 
break; 


switch (index) 

{ 

case  INPUT: 

input  =  e . getActionCommand ( ) ; 
display (input) ; 
trie Id. setText ( "" )  ; 

if  (input. equals ("") )  { display ( "blanks" ); } 

break; 

case  SIM_INTERFACES : 
displayinterfaces ()  ; 
break; 

case  PIB_INTERFACES : 
option  =  0; 

input  =  tField. getText ( ) ; 
if (  ! input. equals  ("")  ) 

{ 

try 

{ 

option  =  Integer .parseint (input) ; 

} 

catch (Exception  ex) { } 

} 


//Default  to  enable  full  detail 
option  =  2; 

synchronized (theLock) 

{ 
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display (pib . toStringInter faces (option) ) ; 

} 

break; 

case  PIB_PATHS: 

synchronized (theLock) 

{ 

display (pib . toStringPaths (2) ) ; 

} 

break; 

case  SIM_QUEUE; 
displayQueue () ; 
break; 

case  SIM_CLS: 

tArea . setText ( "Cleared" )  ; 
break; 

case  SIM_LOAD: 

if(simState  ==  STATE_UNLOADED  ||  simState  ==  STATE_READY_TO_START) 

{ 

simLoad ( ) ; 

simState  =  STATE_READY_TO_START; 

button [SIM_CONTROL] . setText (control [simState] ) ; 

button [SIM_CONTROL] . setEnabled (true) ; 
button [SIM_ABORT] . setEnabled (false)  ; 

runSimulation  =  false; 
isReleased  =  false; 
abortRun  =  false; 

} 

else 

{ 

display ( "Simulation  is  running"); 
simState  =  STATE_UNLOADED; 

} 

break; 

case  SIM_ABORT; 

synchronized (theLock) 

{ 

runSimulation  =  false; 
isReleased  =  true; 
abortRun  =  true; 

} 


try  { 

Thread. sleep  ( 1000 )  ; 

} 

catch (Exception  ex){} 

//Reset  local  set  of  affected  interfaces  and  send  an  LSA  to  PIB 
Enumeration  enum  =  htinterf aces . elements () ; 
while (enum.hasMoreElements () ) 

{ 

Interface  iFace  =  ( Interface) enum. nextElement () ; 
iFace . reset ( ) ; 

} 

processEvent_LSA (new  SimulationEvent (TYPE_LSA,  0,  new  Integer (0))) 

button [SIM_L0AD] . setEnabled (true)  ; 
button [SIM_AB0RT] . setEnabled (false) ; 
button [SIM_C0NTR0L] . setEnabled ( false )  ; 

break; 

case  SIM  CONTROL: 


switch (simState) 
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case  STATE_READY_TO_START;  //O 
runSimulation  =  true; 
simStart ( ) ; 

simState  =  STATE_RUNNING; 
button [SIM_LOAD] . setEnabled ( false ) ; 
button [SIM_CONTROL] . setEnabled (true) ; 
button [SIM_CONTROL] . setText (control [simState] ) ; 
button [SIM_ABORT] . setEnabled (true) ; 
break; 

case  STATE_RUNNING:  //I 

synchronized (theLock) 

{ 

runSimulation  =  false; 
isReleased  =  false; 

} 

simState  =  STATE_STOPPED; 

button [SIM_CONTROL] . setText (control [simState] ) ; 
break; 

case  STATE_STOPPED;  //2 

simState  =  STATE_RUNNING; 
synchronized (theLock) 

{ 

timeFactor  = 

Double . parse Double (txt Field [ SIM_TIME_FACTOR] . getText ( ) ) 
isReleased  =  true; 
abortRun  =  false; 
runSimulation  =  true; 

} 

button [SIM_CONTROL] . setText (control [simState] ) ; 
break; 


break; 

case  PIB_RESET; 

synchronized (theLock) 

( 

pib.processFlowRequest_test (null) ; 

} 

break; 

case  SIM_REFRESH_MODE: 

refreshMode  =  Math. abs (ref reshMode  -  1);  //toggle  refreshMode 
button [SIM_REFRESH_MODE] . setText (modeLabel [ ref reshMode ] ) ; 
break; 

case  PIB_BORROWING: 
synchronized (theLock) 

{ 

if (allowBorrowing  ==  0) 

( 

//Turn  interservice  borrowing  on 
allowBorrowing  =  1; 

pib . se t I nterserviceBor rowing (true ) ; 

} 

else 

( 

//Turn  interservice  borrowing  off 
allowBorrowing  =  0; 

pib . set I nterserviceBor rowing (false ) ; 


button [ PIB_B0RR0WING] . setText (borrowingLabel [allowBorrowing] ) ; 
break; 

case  SIM_EXIT: 

System. exit (0) ; 
break; 
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default : 

display ("No  action  implemented"); 

}//end  switch 
}//end  actioPerformed ( ) 
y  *  * 

*  Opens  a  file  to  output  simulation  results. 

*  @return  boolean  whether  the  operation  succeded. 

*/ 

public  boolean  fileOpenO 

{ 

boolean  isOpen  =  false; 

//First,  ensure  previous  file  is  closed 
f ileClose  ( )  ; 

//Open  the  file 
try 
{ 

dataOut  =  new  PrintWriter ( 

new  FileOutputStream ( txtField [ SIM_FILE_NAME] . getText ( ) ) ,  true); 
isOpen  =  true; 

} 

catch (Exception  e) 

{ 

e .printStackTrace ( ) ; 

} 

return  isOpen; 


y  *  * 

*  Closes  current  opened  file. 

*  @return  void. 

*/ 

public  void  fileCloseO 

{ 

try 

{ 

dataOut . close  ( )  ; 

) 

catch (Exception  e){} 


/  *  * 

*  Simulation  timer  thread.  Controls  the  timing  od  the  simulation  events 

*  when  the  simulation  is  running. 

*  @return  void. 

*/ 

public  void  run ( ) 

{ 

long  simTime  =  0; 
long  sleepTime  =  0; 

SimulationEvent  event; 
long  eventTime  =  0; 
long  lastEventTime  =  0; 

stopThread: 

while ( ! queue . isEmpty ( ) ) 

{ 

//Dequeue  next  event 

event  =  (SimulationEvent) queue .pop ( ) ; 
lastEventTime  =  eventTime; 
eventTime  =  event . getStartTime () ; 

long  timeinterval  = 

(long) ( (Math . abs (eventTime  -  lastEventTime))  *  timeFactor) ; 


//wait  until  event  is  due 
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IblTimer . setText ( f ormatTime ( lastEventTime )  + 

"  -  "  +  String . valueOf ( lastEventTime/ 1000 )) ; 
while (timeinterval  >  0) 

{ 

sleepTime  =  1000; 
if  (timeinterval  <  sleepTime) 

{ 

sleepTime  =  timeinterval; 

} 

timeinterval  -=  sleepTime; 

try 

{ 

Thread. sleep (sleepTime) ; 
simTime  +=  sleepTime; 

IblTimer . setText ( f ormatTime ( lastEventTime )  + 

"  -  "  +  String . valueOf ( lastEventTime/ 1000 )) ; 
boolean  isStopped; 
synchronized (theLock) 

{ 

isStopped  =  ! runSimulation; 

} 

if (isStopped) 

{ 

//Now  loop  and  wait  until  isRelease  is  true 
boolean  loop  =  true; 
do 
{ 

Thread. sleep  ( 1000 ) ; 
synchronized (theLock) 

{ 

loop  =  lisReleased; 

} 

}while (loop) ; 

//isRelease  is  true,  lets  find  what  next  (stop  or  continue) 

if (abortRun) 

{ 

//abort  simulation 
break  stopThread; 

} 

//continue  running  the  simulation 

} 

} 

catch (Exception  e){} 


processEvent (event) ; 

}//end  while  queue  is  not  empty 

//Queue  is  empty  or  abort  button  was  pressed 

if (isReady) 

{ 

simStop ( ) ; 

} 

else 

{ 

//wait  until  pib  is  ready 

display (" \nSAAM  is  not  ready!  Waiting...  \n"); 
boolean  loop  =  true; 
long  count  =  0; 
do 


IblTimer . setText ( f ormatTime ( count) ) ; 
//Check  SAAM  is 
try 
{ 

createFlowRequest_IS (1,2,10,10,10) ; 
isReady  =  true; 
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display (" \nSAAM  is  ready!  Waiting  time:  "  +  formatTime (count) ,  true); 
tArea . setBackground (new  Color(198,237,176)  )  ; 

} 

catch (Exception  e) { } 
if (isReady) 

{ 

loop  =  false; 

button [SIM_LOAD] . setEnabled (true) ; 

} 

else 

{ 

try 

{ 

Thread. sleep ( 1000 )  ; 
count  +=  1000; 

} 

catch (Exception  e){} 

} 

}while (loop) ; 

} 

} 


/  *  * 

*  Generates  normal  variates  in  accordance  with  the  Rejection  Method. 

*  @param  mu  the  mean  value  of  the  normal  distribution. 

*  @param  sigma  the  sigma  value  of  the  normal  distribution. 

*  @return  the  value  of  the  normal  variated  generated. 

*/ 

private  double  normalVariate (double  mu,  double  sigma) 

{ 

//Calculate  a  normal  variate  with  the  rejection  method 
double  ul,  u2,  u3,  x; 

do  { 

ul  =  randomGen . nextDouble  ( ) ; 
u2  =  randomGen . nextDouble 0 ; 

X  =  -Math . log (ul ) ; 

} 

while (u2  >  Math.exp(  - (x-1 ) * (x-1 ) /2 . Od  )); 
u3  =  randomGen . nextDouble 0 ; 
if (u3  >  0 . 5d) 

{ 

return  mu  +  sigma  *  x; 

} 

else 

{ 

return  mu  -  sigma  *  x; 

} 


/  *  * 

*  Loads  the  queue  with  the  specified  flow  request  events. 

*  @param  simDuration  the  duration  of  the  simulation  in  seconds. 

*  @param  svcLevel  the  service  level  of  the  flow  request. 

*  @param  interval  the  mean  value  of  time  between  flow  requests  (seconds) . 

*  @param  durationMean  the  mean  value  for  the  flow  duration  (seconds) . 

*  @param  durationSigma  the  sigma  of  the  duration  distribution. 

*  @param  bandwidth  the  value  of  the  bandwidh  of  each  flow  (bps) . 

*  @return  the  total  number  of  flows  generated. 

*/ 

private  int  loadFlowRequests ( long  simDuration,  byte  svcLevel, 

int  interval,  int  durationMean,  int  durationSigma,  int  bandwidth) 


int  nrFlows  =  0; 
double  randNormal; 
double  interArrivalTime ; 

double  lambda;  //for  the  interarrival  rate  of  flow  requests 

long  flowDuration  =  0;  //for  the  flow  duration  (ms) 

long  simTime  =  0;  //for  the  simulation  time  (ms) 

//Normalize  units 

simDuration  =  simDuration  *  1000;  //duration  of  the  simulation  in  miliseconds 
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//Calculate  arrival  rate  of  new  flow  requests 

lambda  =  l.Od  /  ( (double) (interval) ) ;  //requests  per  second 

while ( simTime  <=  simDuration) 

{ 

//Increment  counter 
nrFlows++; 

//Interarrival  time  of  next  flow  request  (exponetial  distribution) 

//x  =  -1/lambda  *  ln(u)  where  0  <=  u  <  1 

interArrivalTime  =  (-1 . Od/lambda  *  Math . log (randomGen . nextDouble ())) ;  //sec 

//Advance  simulation  time  by  the  interarrival  time 
simTime  +=  (long) (interArrivalTime  *  1000); 

//Generate  new  flow  only  if  begin  of  new  flow  does  not  exceed  simDuration 
if (simTime  <=  simDuration) 

{ 

//Duration  in  miliseconds  (normal  distribution) 
do  { 

flowDuration  = 

(int) (1000  *  normalVariate ( (double) durationMean, 

(double) durationSigma) ) ; 

} while ( flowDuration  <  1000); 

//Create  and  add  the  new  flow  request  event 
if(svcLevel  ==  BasePIB , INT_SERV) 

{ 

queue . add (new  SimulationEvent ( 

TYPE_FLOW_REQUEST, 
simTime , 

simTime  +  flowDuration, 

createFlowRequest_IS ( 1 , 2 , 0 , 0 , bandwidth) ) ) ; 

} 

else  if(svcLevel  ==  BasePIB . DIFF_SERV) 

{ 

queue . add (new  SimulationEvent ( 

TYPE_FLOW_REQUEST, 
simTime , 

simTime  +  flowDuration, 

createFlowRequest_DS ( 1 , 2 , 0 , 0 , bandwidth) ) ) ; 

} 

}//end  if 
}  //end  while 
return  nrFlows; 

} 


/  *  * 

*  Loads  the  simulation  queue  with  the  required  LSA  events. 

*  @param  simDuration  the  duration  of  the  simulation  in  seconds. 

*  @param  IsaCycle  the  LSA  interva  in  miliseconds. 

*  Oreturn  int  the  number  of  LSA  events  generated. 

*/ 

private  int  loadLSA(int  simDuration,  int  IsaCycle) 

{ 

//Advance  dataline  for  the  data  log  output 
dataLine  +=  //columns  5-8 

//Calculate  the  number  of  LSA  cycles 

int  cycles  =  (int) (simDuration*1000/lsaCycle)  +  1; 

//Add  LSA  events 

for (int  i  =  1;  i  <=  cycles;  iff) 

{ 

queue . add (new  SimulationEvent (TYPE_LSA,  IsaCycle  *  i,  new  Integer ( i ))) ; 

} 

return  cycles; 

} 

/  *  * 

*  GUI  support  function.  Retrieves  the  integer  number  of  the  text  field. 

*  @param  txt  the  text  field. 
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*  @return  the  number  retrieved. 

*/ 

private  int  getValue ( JTextField  txt) 

{ 

return  Integer . parse Int (txt . getText ( ) ) ; 

} 


/  *  * 

*  Loads  a  new  simulation  with  current  GUI  values. 

*  @return  void. 

*/ 

private  void  simLoadO 

{ 

display (" \nLoading  a  new  simulation..."); 

//Reset  simulation 

pib.processFlowRequest_test (null) ;  //Reset  PIB 
display ("LSA  transmitted  to  reset  PIB  QoS  data"); 


reqCount[IS]  =  0; 
reqCount[DS]  =  0; 

req  =  new  boolean[2] [movAvgWindowSize] ;  //For  the  moving  average 
for  (int  i  =  0;  i  <  INT;  i++) 

{ 

data [DS] [i]  =  0; 
data [IS] [i]  =  0; 


for  (int  i  =  0;  i  <  DBL;  i++) 


rrData [DS] [i]  =  0; 
rrData [IS] [i]  =  0; 


ref reshSimOutput  ( )  ; 
queue . clear  ( )  ; 
eventCounter  =  0; 


htinterfaces . clear ( ) ; 
ref reshSimOutput ( ) ; 


//Simulation  data 

double  d  =  Double .parseDouble (txtField [SIM_ALPHA] . getText ()) ; 
borrowingThreshold  = 

(double) Integer .parse Int (txtField [SIM_THRESHOLD] . getText ( ) ) /lOO . Od; 
pib . setBorrowingThreshold (borrowingThreshold) ; 


int  simDuration 

movAvgWindowSize 

IsaCycle 

seed 

alphaFactor 

timeFactor 


Integer .parse Int (txtField [SIM_DURATION] . getText ( ) ) ; //sec 
Integer . parse Int (txtField [ SIM_MOV_AVG_WINDOW] . getText ( ) ) 
Integer .parse Int (txtField [SIM_LSA_CYCLE] . getText ( ) ) ; //ms 
Long . parseLong (txtField [ SIM_SEED] . getText ( ) ) ; 

Double . parseDouble (txtField [ SIM_ALPHA] . getText ( ) ) ; 

Double .parseDouble (txtField [SIM_TIME_FACTOR] .getText () ) ; 


randomGen  =  new  Random ( seed) ; 


//IntServ  flow  charaterization 

f lowReqIntervallS  =  Integer . parse Int (txtField [ IS_ARRIVALS ] . getText ( ) ) ; / /sec 
durationMeanIS  =  Integer . parseint (txtField [ IS_MU] . getText ()) ;  //sec 
durationSigmalS  =  Integer . parseint (txtField [ IS_SIGMA] . getText ()) ;  //sec 

flowBwIS  =  1000  *  Integer .parseint (txtField [ IS_BW] . getText 0) ;  //bps 

//DiffServ  flow  charaterization 

f lowReqIntervalDS  =  Integer .parseint (txtField [ DS_ARRIVALS ] . getText ( ) ) ; / /sec 
durationMeanDS  =  Integer . parseint (txtField [ DS_MU] . getText ()) ;  //sec 
durationSigmaDS  =  Integer . parseint (txtField [ DS_SIGMA] . getText ()) ;  //sec 

flowBwDS  =  1000  *  Integer . parseint (txtField [ DS_BW] . getText 0) ;  //bps 

//Load  IS  flow  request  events 

int  nFlowReqs  =  loadFlowRequests (simDuration,  BasePIB . INT_SERV, 
flowReqIntervallS,  durationMeanIS,  durationSigmalS,  flowBwIS) ; 
display ( "Queue  loaded  with  "  +  nFlowReqs  +  "  IS  flow  requests"); 
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//Load  DS  flow  request  events 

nFlowReqs  =  loadFlowRequests (simDuration,  BasePIB . DIFF_SERV, 

f lowReqIntervalDS ,  durationMeanDS ,  durationSigmaDS,  flowBwDS) ; 
display ( "Queue  loaded  with  "  +  nFlowReqs  +  "  DS  flow  requests"); 

//Load  LSA  events 

int  nLSAs  =  loadLSA (simDuration,  IsaCycle) ; 

display ( "Queue  loaded  with  "  +  nLSAs  +  "  LSA  events"); 

//Display  simulation  projections 

pro jActiveFlowsIS  =  Math . round (durationMeanIS  /  flowReqIntervallS) ; 
pro j ActiveFlowsDS  =  Math . round (durationMeanDS  /  flowReqIntervalDS) ; 

display ("\nProjected  network  load  demand  (no  rejections) : \n") ; 
display ("\tSL\tActive  flows  \tBandwidth  (kbps) \n") ; 
display ("\tIS\t"  +  pro jActiveFlowsIS  +  "\t\t"  + 

(Math , round (durationMeanIS  /  flowReqIntervallS)  *  flowBwIS  /  1000)) 
display ("\tDS\t"  +  pro j ActiveFlowsDS  +  "\t\t"  + 

(Math , round (durationMeanDS  /  flowReqIntervalDS)  *  flowBwDS  /  1000)) 
display ("\nSimulation  is  ready  to  start"); 


/  *  * 

*  Refreshes  GUI, 

*  Oreturn  void. 

*/ 

private  void  ref reshSimOutput ( ) 

{ 

//Refresh  the  rejection  rate 
if (data [IS] [REQ]  >  0) 

{ 

rrData [IS] [RJR]  =  (double ) data [ IS ] [RE J] / (double ) data [ IS ] [REQ] ; 

} 

if (data [DS] [REQ]  >  0) 

{ 

rrData [DS] [RJR]  =  (double) data [DS] [REJ] / (double) data [DS] [REQ] ; 

} 


//Refresh  gui  with  current  data 
for (int  i  =  0;  i  <  INT;  i++) 

{ 

dataLabel [IS] [i] . setText (String. valueOf (data [IS] [i] ) ) ; 
dataLabel [DS]  [i] . setText (String. valueOf (data [DS]  [i] ) )  ; 


dataLabel  [IS]  [ACT]  .  setText  (dataLabel  [ IS]  [ACT]  .getTextO  + 

"  ["+  projActiveFlowsIS  +  "]"); 
dataLabel  [DS]  [ACT]  .  setText  (dataLabel  [DS]  [ACT]  .getTextO  + 

"  ["+  pro j ActiveFlowsDS  +  "]"); 

for (int  i  =  0;  i  <  DEL;  i++) 

{ 

dataLabel [IS] [INT  +  i].setText(  df.format(rrData[IS][i])); 
dataLabel [DS] [INT  +  i]. setText (  df . format (rrData [DS] [i] )) ; 


y  *  * 

*  Generates  a  single  IS  Flow  Request  message. 

*  @param  srcNodelD  the  source  node  ID 

*  @param  destNodelD  the  destination  node  ID 

*  @param  delay  the  flow  delay  bound 

*  @param  lossRate  the  loss  rate  bound 

*  @param  bandwidth  the  bandwidth  bound 

*  Oreturn  the  IS  flow  request  message 

*/ 

private  FlowRequest  createFlowRequest_IS ( 
int  srcNodelD, 
int  destNodelD, 
int  delay. 
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int  lossRate, 
int  bandwidth) 

{ 

return  new  FlowRequest  ( 

( IPvGAddress ) pib . htNodelDtoRouterlD . get (new  Integer ( srcNodelD) ) , 

( IPvGAddress ) pib . htNodelDtoRouterlD . get (new  Integer (destNodelD) ) , 
System. currentTimeMillis () , 

(short) delay,  (short) lossRate,  bandwidth) ; 


!  -k  -k 

*  Generates  a  single  DS  Flow  Request  messages. 

*  @param  srcNodelD  the  source  node  ID 

*  @param  destNodelD  the  destination  node  ID 

*  @param  delay  the  flow  delay  bound 

*  @param  lossRate  the  loss  rate  bound 

*  @param  bandwidth  the  bandwidth  bound 

*  @return  the  DS  flow  request  message 

k  / 

private  FlowRequest  createFlowRequest_DS ( 
int  srcNodelD, 
int  destNodelD, 
int  delay, 
int  lossRate, 
int  bandwidth) 

{ 

int  userlD  =  6; 
return  new  FlowRequest ( 

( IPvGAddress ) pib . htNodelDtoRouterlD . get (new  Integer (srcNodelD) ) , 

( IPvGAddress ) pib . htNodelDtoRouterlD . get (new  Integer (destNodelD) ) , 
System. currentTimeMillis () , 

userlD,  (short) delay,  (short) lossRate,  bandwidth) ; 


!  k  k 

*  Stops  a  running  simulation. 

*  @return  void. 

*/ 

private  void  simStopO 

{ 

display ( "Simulation  run  terminated!!"); 
f ileClose  ( )  ; 
simState  =  -1; 

button [SIM_LOAD] . setEnabled (true) ; 
button [SIM_CONTROL] . setEnabled ( false ) ; 


/  *  * 

*  Starts  a  simulation. 

*  @return  void. 

k  / 

private  void  simStartO 

{ 

display (" \nStarting  a  new  simulation"); 
if  (fileOpen ( ) ) 

{ 

//Write  to  file  data  of  this  simulation  run 


dataOut.println ("Isa, "  +  IsaCycle) ;  //ms 

dataOut.println ( "timeFactor , "  +  timeFactor) ; 
dataOut . println ( "EMA  -  weight,"  +  alphaFactor) ; 
dataOut.println ("seed, "  +  seed);  //ms 

dataOut.println ("movAvgWindowSize, "  +  movAvgWindowSize) ;  //flow  reqs 
dataOut . println ( "borrowingThreshold, "  +  borrowingThreshold) ; 
dataOut.println ("is_arrivals, "  +  flowReqIntervallS) ;  //sec 

dataOut.println ("is_meanDuration, "  +  durationMeanIS) ;  //sec 

dataOut.println ("is_sigmaDuration, "  +  durationSigmalS) ;  //sec 

dataOut.println ("is_bw, "  +  flowBwIS) ;  //bps 

dataOut . println ( "ds_arrivals , "  +  flowReqIntervalDS) ;  //sec 

dataOut.println ("ds_meandDuration, "  +  durationMeanDS) ;  //sec 

dataOut.println ( "ds_sigmaDuration, "  +  durationSigmaDS) ;  //sec 
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//bps 


dataOut . println ( "ds_bw, "  +  flowBwDS) ; 
dataOut . println ( "borrowing, "  +  allowBorrowing); 
dataOut . println ( "pro jActiveFlowsIS , "  +  projActiveFlowsIS) ; 
dataOut . println ( "pro jActiveFlowsDS , "  +  projActiveFlowsDS) ; 

int  colCount  =  0; 

for(colCount  =  1;  colCount  <  19;  colCount++) 

{ 

dataOut. print (colCount  + 

} 

dataOut. println (colCount) ; 

//Start  timer 
timer  =  new  Thread (this) ; 
timer . start ( ) ; 

} 

else 

{ 

display ("\n") ; 

display ("  ************************************************************"); 
display ("  *  WARNING;  Could  not  open  file  for  data  output  *") ; 

display)"  ************************************************************"); 


*  This  class  is  used  to  define  simulation  events. 

*  @author  Paulo  Silva  (August  2001) 

*/ 

private  class  SimulationEvent 

{ 

private  byte  eventType; 
private  long  startTime; 
private  long  stopTime; 
private  Object  eventObject; 

private  String  []  typeLabel  =  {"Flow  request",  "Flow  termination",  "LSA"}; 

/  *  * 

*  Constructs  a  generic  simulation  event. 

*  Sparam  eventType  the  type  of  event. 

*  @param  the  event  start  time. 

*  @param  the  event  stop  time. 

*  @param  anyObject  the  event  object  to  be  associated  with  this  event. 

*/ 

public  SimulationEvent (byte  eventType,  long  startTime,  long  stopTime,  Object  anyObject) 

{ 

this . eventType  =  eventType; 
this . StartTime  =  startTime; 
this . StopTime  =  stopTime; 
this . eventObject  =  anyObject; 

} 

/  *  * 

*  Constructs  a  flow  request  event. 

*  @param  eventType  the  type  of  event. 

*  @param  the  event  start  time. 

*  @param  anyObject  the  event  object  to  be  associated  with  this  event. 

*/ 

public  SimulationEvent (byte  eventType,  long  startTime,  Object  anyObject) 

{ 

this . eventType  =  eventType; 
this . StartTime  =  startTime; 
this . StopTime  =  startTime; 
this . eventObject  =  anyObject; 

} 


/  *  * 

*  Retrieves  the  event  type. 

*  @return  the  type  of  event 
*/ 

public  byte  getTypeO 
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{ 


return  eventType; 

} 

/  *  * 

*  Retrieves  the  start  time  of  the  event. 

*  @return  the  start  time  of  the  event. 

*/ 

public  long  getStartTime ( ) 

{ 

return  startTime; 

} 


/  *  * 

*  Retrieves  the  stop  time  of  the  event. 

*  @param  the  stop  time  of  the  event. 

*/ 

public  long  getStopTime ( ) 

{ 

return  stopTime; 

} 


/  *  * 

*  Retrieves  the  event  object. 

*  @param  the  event  object 
*/ 

public  Object  getEventObject ( ) 

{ 

return  eventObject; 

} 


/  *  * 

*  String  representation  of  this  event. 

*  @return  a  string  representation  of  this  event. 

*/ 

public  String  toStringO 

{ 

String  out  =  "  "  +  formatTime ( startTime )  +  "  -  "  +  typeLabel [eventType-1 ] 

if  (eventType  ==  TYPE_FLOW_REQUEST) 

{ 

byte  srvLevel  =  ( (FlowRequest) eventObject) . getServiceLevel () ; 

String  svc  =  (srvLevel  ==  1)  ?  "IS"  :  "DS"; 

int  duration  =  (int) ((stopTime  -  startTime )/ 1000 ) ; 

out  +=  "  ["  +  SVC  +  "]  duration  =  "  +  duration  +  "  secs"; 

} 

return  out; 

} 

}//  end  of  class  SimulationEvent 
/  *  * 

*  This  class  defines  a  flow  termination  data  object.  This  object  is  used  to 

*  associated  single  flow  data  with  a  single  interface.  A  flow  termination 

*  event  is  made  of  one  or  more  of  these  objects. 

*  @author  Paulo  Silva  (August  2001) 

*/ 

private  class  FlowTerminationData 

{ 

private  String  address; 
private  byte  serviceLevel; 
private  int  bandwidth; 

/  *  * 

*  Constructor. 

*  @param  address  the  IPv6  address  of  the  interface. 

*  @param  serviceLevel  the  service  level. 

*  @param  bandwidth  the  bandwidth  assigned  to  the  terminated  flow. 

*/ 

public  FlowTerminationData ( String  address,  byte  serviceLevel,  int  bandwidth) 

{ 


this. address  =  address; 
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this . serviceLevel  =  serviceLevel; 
this . bandwidth  =  bandwidth; 


/  *  * 

*  Retrieves  the  address. 

*  Sreturn  the  address. 

*/ 

public  String  getAddressO 

{ 

return  address; 

} 


/  *  * 

*  Retrieves  the  service  level. 

*  @return  the  service  level. 

*/ 

public  byte  getServiceLevel ( ) 

{ 

return  serviceLevel; 

} 


/  *  * 

*  Retrieves  the  bandwidth. 

*  @return  the  bandwidth. 

*/ 

public  int  getBandwidth ( ) 

{ 

return  bandwidth; 

} 


}  //  end  of  class  FlowTerminationData 

//--GreaterThen - 

/  *  * 

*  This  class  implements  the  method  required  by  the  priority  queue  to 

*  give  its  ordering  behaviot. 

*  @author  Paulo  Silva  (August  2001) 

*/ 

private  class  GreaterThan  implements  BinaryPredicate 

{ 

public  boolean  execute (Object  objl.  Object  obj2) 

{ 

boolean  result  =  true; 

long  first  =  ( ( SimulationEvent ) ob j 1 ) . getStartTime ( ) ; 
long  second  =  (( SimulationEvent ) obj 2 ). getStartTime () ; 

if  (first  <  second) 

{ 

result  =  false; 

} 

return  result; 

} 

}//  end  of  class  BynaryPredicate 
/  *  * 

*  This  class  defines  an  Interface  object  to  be  used  only  within  the  tester. 

*  @author  Paulo  Silva  (August  2001) 

*/ 

private  class  Interface 

{ 

private  int[]  slAllocatedBW; 
private  String  routerlD; 
private  int  bandwidth; 

/  *  * 

*  Constructor. 

*  @param  routerlD  the  routerlD. 

*  @param  interfaceBandwidth  the  total  bandwidth  of  the  interface. 

*/ 

public  Interface ( String  routerlD,  int  interfaceBandwidth) 
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{ 

slAllocatedBW  =  new  int [pib.NUM_OF_SERVICE_LEVELS  -  1]; 

for  (byte  si  =  0;  si  <  pib . NUM_OF_SERVICE_LEVELS  -  1;  sl++) 

{ 

SlAllocatedBW [si]  =  0; 

} 

setRouterlD (routerlD)  ; 
setBandwidth (InterfaceBandwidth) ; 


/  *  * 

*  Increases  the  allocated  bandwidth  of  a  service  level  by  the  given 

*  amount . 

*  @param  serviceLevel  the  servicel  level. 

*  @param  bandwidth  the  bandwidth  allocation  increase. 

*  @return  void. 

*/ 

public  void  increaseAllocatedBW (byte  serviceLevel,  int  bandwidth) 

{ 

slAllocatedBW [ serviceLevel ]  +=  bandwidth; 

} 


/  *  * 

*  Sets  a  new  bandwidth  allocation  value. 

*  @param  serviceLevel  the  servicel  level. 

*  @param  bandwidth  the  bandwidth  allocation  increase. 

*  @return  void. 

*/ 

public  void  setAllocation (byte  serviceLevel,  int  bandwidth) 

{ 

slAllocatedBW [ serviceLevel ]  =  bandwidth; 

} 

/  *  * 

*  Sets  a  new  value  for  the  router  ID. 

*  @param  routerlD  the  IPv6  based  value  for  the  router  ID. 

*  @return  void. 

*/ 

public  void  setRouterlD (String  routerlD) 

{ 

this . routerlD  =  routerlD; 

} 


y  *  * 

*  Retrieves  the  router  ID  value. 

*  @return  the  router  ID. 

*/ 

public  String  getRouterlD ( ) 

{ 

return  routerlD; 

} 


/  *  * 

*  Sets  the  new  value  for  the  total  bandwidth  of  the  interface. 

*  @param  newBandwidth  the  new  value  of  the  bandwidth. 

*  @return  void. 

*/ 

public  void  setBandwidth (int  newBandwidth) 

{ 

bandwidth  =  newBandwidth; 

} 


/  *  * 

*  Retrieves  the  interface  total  bandwidth. 

*  @return  the  interface  bandwidth. 

*/ 

public  int  getBandwidth ( ) 

{ 

return  bandwidth; 

} 
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y  *  * 

*  Resets  the  allocated  bandwith. 

*  @return  void. 

*/ 

public  void  reset () 

{ 

for(int  1=0;  1  <  3;  ill) 

{ 

slAllocatedBW [i]  =  0; 

} 

} 


/  *  * 

*  Decreases  the  allocated  bandwidth. 

*  @param  serviceLevel  the  service  level. 

*  @param  bandwidth  the  amount  of  bandwidth  decrease. 

*/ 

public  void  decreaseAllocatedBW (byte  serviceLevel,  int  bandwidth) 

{ 

SlAllocatedBW [ serviceLevel ]  -=  bandwidth; 

} 


public  int  getAllocatedBW (byte  serviceLevel) 

{ 

return  slAllocatedBW [ serviceLevel ]  ; 

} 

}//end  of  Interface  class 
}//end  of  BasePIBTester  class 
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APPENDIX  D  TEST  AND  EVALUATION  DATA 


Te  following  table  summarizes  the  data  obtained  from  40  simulation  runs. 


Inter-Service  Borrowing 


Disabled 


Enabled 


Difference 


Change 


Simulation  Run  A 


IntServ 

Flow  Requests 

Flow  Rejections 

Flow  Rejections  (%) 

Active  Flows  (avg) 

Aggregated  Throughput 

723 

37 

5.0 

91.3 

547  847 

723 

23 

3.2 

93.4 

560  531 

0 

-13.5 

-1.8 

2.1 

12  684 

-36  % 

Flow  Requests 

79 

79 

0 

Flow  Rejections 

0 

0 

0 

Flow  Rejections  (%) 

0 

0 

0 

Q 

Active  Flows  (avg) 

20.8 

20.8 

0 

Aggregated  Throughput 

145  758 

145  833 

75 

Simulation  Run  B 


IntServ 

Flow  Requests 

Flow  Rejections 

Flow  Rejections  (%) 

Active  Flows  (avg) 

Aggregated  Throughput 

712 

54 

7.4 

92.9 

557  417 

723 

35 

4.8 

96.1 

576  664 

11 

-18.5 

-2.6 

3.2 

19  247 

-35  % 

Flow  Requests 

76 

79 

2.5 

Flow  Rejections 

0 

0 

0 

Flow  Rejections  (%) 

0 

0 

0 

Q 

Active  Flows  (avg) 

21.1 

21.1 

0.1 

Aggregated  Throughput 

147  374 

147  800 

426 
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Simulation  Run  C 


Inter-Service  Borrowing 


Disabled 


Enabled 


Difference 


Change 


Flow  Requests 

704 

712 

8 

Flow  Rejections 

62 

46 

-16 

(1> 

00 
-J— > 

Flow  Rejections  (%) 

8.6 

6.3 

-2.3 

-27% 

l-H 

Active  Flows  (avg) 

93.9 

96.8 

2.9 

Aggregated  Throughput 

563  421 

580  787 

17  366 

Flow  Requests 

78 

76 

-1.3 

> 

Flow  Rejections 

0 

0 

0 

Cm 

Flow  Rejections  (%) 

0 

0 

0 

Q 

Active  Flows  (avg) 

20.7 

21.1 

0.4 

Aggregated  Throughput 

145  021 

147  743 

2  722 

Simulation  Run  D 


IntServ 

Flow  Requests 

Flow  Rejections 

Flow  Rejections  (%) 

Active  Flows  (avg) 

Aggregated  Throughput 

719 

80 

11.1 

94.7 

568  411 

719 

55 

7.6 

99.4 

596  332 

0 

-25 

-3.5 

4.7 

27  921 

-31% 

Flow  Requests 

76 

76 

0 

Flow  Rejections 

0 

0 

0 

Flow  Rejections  (%) 

0 

0 

0 

Q 

Active  Flows  (avg) 

19.9 

19.9 

0 

Aggregated  Throughput 

139  572 

139  588 

16 
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Simulation  Run  E 


Inter-Service  Borrowing 


Disabled 


Enabled 


Difference 


Change 


Flow  Requests 

719 

719 

0 

Flow  Rejections 

98 

71 

-27.0 

(1> 

00 
-J— > 

Flow  Rejections  (%) 

13.6 

9.9 

-3.8 

-28% 

l-H 

Active  Flows  (avg) 

95.6 

100.1 

4.5 

Aggregated  Throughput 

573  737 

600  503 

26  766 

Flow  Requests 

76 

76 

0 

> 

Flow  Rejections 

0 

0 

0 

Cm 

Flow  Rejections  (%) 

0 

0 

0 

Q 

Active  Flows  (avg) 

19.9 

19.9 

0 

Aggregated  Throughput 

139  572 

139  583 

11 
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